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WELCOME 


WELCOME! 


s we reach a huge milestone with 100 issues of 
The MagPi magazine, we have more projects and 
guides than ever to choose from for this new 
Official Raspberry Pi Handbook. Squeezing in as many 
amazing projects as we could, we hope they provide 
great inspiration for your own makes. 

The imagination and talent on show from the maker 
and Raspberry Pi community never ceases to amaze us. 
This book is a testament to just what people can do with 
a little knowledge and the perseverance to succeed, and 
I hope it inspires you for years to come. 

If you’re new to Raspberry Pi, then welcome! 

You’ve joined us at an exciting time with the release 
of Raspberry Pi 400, and you can still do amazing 
things with a standard Raspberry Pi model. We’11 
show you how to get yourselves set up, then you can 
find out exactly what you can do with your amazing 
new computer. 

With that, I’ll leave you all to enjoy the book. 

Happy making! 





Rob Zwetsloot 
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26 RadioGlobe 


This globe rotates and plays a radio station 
for the selected location 


32 WeatherMan 
A classic Sony Walkman upcycled into a 
weather-predicting smart device 


36 PiCommander 
Converting an old electronic toy into a retro 
games machine 


38 Oktoberfest Pinball Machine 
By the power of Raspberry Pi, you can play 
real pinball online 


42 Astrophotography Autoguider 
Keep your telescope steady to take perfect 
pictures of the night sky 


46 Hot Spotter 
An autonomous drone that can detect and 
report smouldering fires 


50 Aquatic Mini Observation 
system 

This solar-powered, autonomous boat 

measures water quality 


52 Airdrum 
This drum kit can be played with a hover of 
your hands 


54 Cheeseborg 
A dedicated, hands-free grilled cheese 
making robot 





Project Showcases 


58 Bit Time — Rotary Dial 
Phone Project 
Using two upcycled retro phones to explore 


how people communicate 


60 NeoPixel LED Mirror 


A magic mirror that shows you your reflection 
in LEDs 


64 AdventurePi 
Portable arcade project lets you choose your 
own adventure 


66 Reachy 
Meet this surprisingly expressive and flexible 
open-source robot 


68 ElCarrillon 
Hacking the bells of an enormous tower to 
ring the changes 


72 Bellagio Water Show 
This miniature fountain features water jets 
synchronised to music 


74 Raspberry Pine 
The desktop computer with a wooden- 
framed display 


76 Instaclock 
A unique digital clock using two Raspberry Pi 
computers and screens 


80 CNC Etch-A-Sketch 
Using rotary encoders to control the knobs on 
a classic drawing toy 


82 Solar-powered 
Raspberry Pi Camera 
This home CCTV system is powered by the sun 





84 Flying Saucer Clock and NAS 


An out-of-this-world way to tell the time and 


store your files 


86 Chamber: Sourdough Incubator 
Regulate the temperature of your sourdough 
starter to perfection 


88  DropStitch 
Creating amazing embroidery with wireless 
file transfer 


90 RIoT Brick 
Track a runner's progress with this portable 
sensing station 


94 HAL 9000 Google Assistant 
A voice assistant with the looks and 
personality of a film star! 


98 Apollo Pi 
Thermal sensing camera disguised as a 
1970S microwave scanner 


102 BeeMonitor 
Keeping an eye on bee life cycles with 
Raspberry Pi 
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104 Giant Battleships 
Play the classic board game on a giant 
LED matrix 


106 Coffee Maker ‘Greenhouse’ 


Upcycle an old coffee maker to water plants 


108 Piano-Playing Robot 
It can play scales, chords, and tunes and 
even read music 


110 Singing Toilet 
A choir of loo rolls start singing when the 
paper is pulled 


112 Migration Museum 
Celebrating the diversity of London with 
interactive artefacts 


116 Project Zed 
Sci-fi inspired large robot made from old 
printer parts 


120 PiMowBot 


Raspberry Pi-powered robotic lawn-mower 


124 Retro gaming NES frame 


Displaying pixel art on an old game cartridge 


126 Black Lives Matter projection 
Thought-provoking video projection 
powered by Raspberry Pi 


130 The Swirl Machine 
Make fantastic artworks by spinning and 
sloshing wine 


/MakerGuides Guides 


136 50 Raspberry Pi Tips and Tools 
A huge range of physical and digital tools to 
improve your making skills 


144 Starter Electronics with 
Raspberry Pi 

If you bought a Raspberry Pi to learn how to 

make electronic gizmos, you're in for a treat 


154 Build the Ultimate 

Magic Mirror 
Everything you need to make this popular 
Raspberry Pi project 


1/4 Raspberry Pi Problems Solved 


Diagnose and fix issues on your Raspberry Pi 





ee 


186 MARS. Rover 
Explore new territory with this 
sophisticated six-wheeled 
robot kit 


188 SmartiPi Touch 2 
Smart-looking case for the 
discerning touchscreen user 


189 Enviro 
Environment-sensing board with 
a mini LCD screen 


190 Argon Neo & 
Fan HAT 


Stylish protective case with 
optional fan add-on 


192 RedBoard+ 


Feature-packed robotics board 
with plenty of power 


194 Unicorn HAT Mini 
Versatile mini RGB LED matrix 
with bright pixels 





195 HAT Hacker HAT 
Two sets of 40 GPIO pins to 
connect multiple boards 


196 RetroFlag GPi Case 
Eighties handheld-inspired case 
with screen 


197 Maker pHAT 
A board to help you get started 
with physical computing 


198 10 Best: Raspberry Pi 


Cases 
Keep your Raspberry Pi safe 
with these amazing cases 


200 10 Best: Starter kits 
Get started with your Raspberry 
Pi journey 
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QuickStart Guide 


Setting up Raspberry Pi is pretty straightforward, Just 


follow the advice of Rosie Hattersley 


ongratulations on becoming a Raspberry Pi explorer. 

We’re sure you’ |l enjoy discovering a whole new world 

of computing and the chance to handcraft your own 
games, control your own robots and machines, and share 
your experiences with other Raspberry Pi fanatics. 

Getting started won’t take long: just corral the extra bits 
and bobs you need on our checklist. Useful additions include 
some headphones or speakers if you’re keen on using 
Raspberry Pi as a media centre or a gamepad for use as a retro 
games console. 

To get set up, simply use your pre-written microSD 
card (or use Imager to set up acard) and connect all the 
cables. This guide will lead through each step. You’|1 find 
the Raspberry Pi OS, including coding programs and office 
software, all available to use. After that, the world of digital 
making with Raspberry Pi awaits you. 
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What you need 


All the bits and bobs you need 
to set up a Raspberry Pi computer 


A Raspberry Pi 

Whether you choose the new Raspberry Pi 
400; or a Raspberry Pi 4, 3B+, 3B, Pi Zero, 
Zero W, or Zero WH (or an older model 

of Raspberry Pi), basic setup is the same. 
All Raspberry Pi computers run from a 
microSD card, use a USB power supply, 
and feature the same operating systems, 
programs, and games. 





8GB microSD card 

You’ll need a microSD card with a capacity of 

8GB or greater. Your Raspberry Pi uses it to store 
games, programs, and boot the operating system. 
Many Raspberry Pi computer kits come with a card 
pre-written with Raspberry Pi OS. If you want to 
reuse an old card, you'll need a card reader: either 


USB or a microSD to full-sized SD (pictured). 


Raspberry Pi, Mac or PC computer 
You’ll need a computer to format the microSD 
card and copy Raspberry Pi OS. It doesn’t 
matter what operating system this 
computer runs, because 
it’s just for copying the 
files across. 








USB keyboard 

Like any computer, you need a means to enter 

web addresses, type commands, and otherwise 
control Raspberry Pi. The new Raspberry Pi 400 
comes with its own keyboard. Raspberry Pi sells an 
official Keyboard and Hub (magpi.cc/keyboard ) 
for other models. 





RRY PI QUICKSTART GUIDE | Tutcrial 





USB mouse 

A tethered mouse that physically attaches to your 
Raspberry Pi via a USB port is simplest and, unlike a 
Bluetooth version, is less likely to get lost just when 
you need it. Like the keyboard, we think it’s best to 
perform the setup with a wired mouse. Raspberry Pi 
sells an Official Mouse (magpi.cc/mouse). 


Power supply n 
Raspberry Pi 4 and Raspberry Pi 400 

need a USB Type-C power supply. ‘ 
Raspberry Pi sells power supplies Fs 
(magpi.cc/usbcpower), which ’ \ : 
provide a reliable source of power. A y ~, 
Raspberry Pi1,2, 3 and Zero models L- 
need a micro USB power supply = | 
(magpi.cc/universalpower). ~~ 


a 


Display and HDMI cable 


A standard PC monitor is ideal, as 
the screen will be large enough 
to read comfortably. It needs 

to have an HDMI connection, 

as that’s what’s fitted on your 
Raspberry Pi board. Raspberry 

Pi 4 and 400 can power two HDMI 
displays, but require a micro- 
HDMI to HDMI cable. Raspberry 
Pi 3B+ and 3A+ both use regular 
HDMI cables; Raspberry Pi 

Zero W needs a mini HDMI to 
HDMI cable (or adapter). 





USB hub 

Raspberry Pi Zero and Model A boards have a 

single USB socket. To attach a keyboard 

and mouse (and other items) you 

should get a four-port USB hub (or y 

use the official USB Keyboard \ 

and HUB keyboard with a hub built in). ~ 

Instead of standard-size USB ports, 

Raspberry Pi Zero has a micro USB port A 


(and usually comes with a micro USB to BS 


USB-A adapter). 
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The USB-C socket is used to connect power 
to the Raspberry Pi 400. You can use a 
fore) aa)ey=14]0)K-m Ups) =i Om olen /{-)ar-lel=|e1X-1marelelare! 


fo) a c=xex=1 a] maare)e)|K=m ©)ale)ai=1-) Ke) metsi-m- i el--J e1e) (=) 
power adapter such as the Raspberry Pi 
15.3W USB-C Power Supply. 








set up 
Raspberry P1 400 


Raspberry Pi 400 has Its own keyboard 
- all you need to connect Is the mouse 
gnd power 


Connect ag mouse 

Connect a wired USB mouse to the white 
USB connection on the rear of Raspberry Pi 400. 
The two blue USB 3.0 connectors are faster and best 
reserved for external drives and other equipment 
that need the speed. 


B Raspberry Pi 


Facet eepheerry Pl eo) et COS Pe re 
Tiree, Oe =I | 


| leprae 
tale 
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ai atom 14 a\~)aal-1mcvelel (-)mer- lal ol-mulsi-le Ko mere) glaives 
Raspberry Pi 400 directly to a network router (such 
re\ow= Ma alele(=)aaVAgeleln-lar-imare)aat=)e-lareme(-1mlalk-lgaicys 


access. Alternatively, you can choose a wireless 
ANN Mal=1 fo) ee lela lave mi tal=m\d-1 Level atom eo) celersso-n 





j—[o! 





Attach the micro-HDMI cable 
Next, connect a micro-HDMI cable to one of 
the micro-HDMI sockets on the rear of Raspberry 
Pi 400. The one next the microSD card slot is the 
first one, but either connection should work. 
Connect the other end of the HDMI cable to an 
HDMI monitor or television. 





The microSD 

If you purchased a Raspberry Pi 400 
Personal Computer Kit, the microSD card will come 
with Raspberry Pi OS pre-installed. All you need 

to do is connect the power and follow the welcome 
instructions. If you do not have a Raspberry Pi OS 
pre-installed microSD card, follow the instructions 
later in ‘Set up the software’. 








RASPBERRY PI QUICKSTART GUIDE | Tutorial 


Set up Connect gd mouse 


Connect a USB wired mouse to one of the 


R ad S pb eC Ty Pp ] other larger USB-A sockets on Raspberry Pi. As 


with the keyboard, it is possible to use a Bluetooth 
wireless mouse, but setup is much easier with a 


Raspberry P| 4 / 8B+ / 3 has plenty of wired connection. 
connections, making it easy to set up 





Hook up the keyboard HDMI cable 

Connect a regular wired PC (or Mac) Next, connect Raspberry Pi to your display 
keyboard to one of the four larger USB-A sockets using an HDMI cable. This will connect to one 
on a Raspberry Pi 4 / 3B+/ 3. It doesn’t matter of the micro-HDMI sockets on the side of a 
which USB-A socket you connect it to. It is possible Raspberry Pi 4, or full-size HDMI socket ona 
to connect a Bluetooth keyboard, but it’s much Raspberry Pi 3/3B+. Connect the other end of the 
better to use a wired keyboard to start with. HDMI cable to an HDMI monitor or television. 


A HDMI cable, such as ones used by most 
modern televisions, is used to connect 
Raspberry Pi to a TV or display. You'll needa 
‘a al(ol gore mn |B) V1 Kom 1D) \1) Mor-lo)K-m (om al,/ce) mk es\-1m 5/0) 
a Raspberry Pi 4. Or a regular HDMI cable for 
Raspberry Pi 3B+ / 3 (or older) models. 


A regular wired mouse is connected 
to any of the USB-A sockets. A wired 
i <=aV] ofel=1ge Mismere) alal=rea kre em=lale)darcls 

of the USB-A sockets. If you have a 
Raspberry Pi 4, it's best to keep the 
faster (blue) USB 3.0 sockets free for 
flash drives or other components. 
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set up 
Raspberry 
P1 Zero 


You'll need g couple of adapters to 
set up a Raspberry Pi Zero / W / WH 


Get it connected 

If you’re setting up a smaller Raspberry 

Pi Zero, you’ll need to use a micro USB to USB-A 
adapter cable to connect the keyboard to the 
smaller connection on a Raspberry Pi Zero W. The 
latter model has only a single micro USB port for 
connecting devices, which makes connecting both 
a mouse and keyboard slightly trickier than when 
using a larger Raspberry Pi. 
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You'll need this micro USB 
to USB-A adapter to connect 
wired USB devices suchasa 
laalele t= Valem «ov elel- com comvolule 
Raspberry Pi Zero W 





Raspberry Pi Zero W features a 
mini-HDMI socket. You'll need 
a mini-HDMI to full-sized HDMI 
reYefsle)k=)a Com nal smkemero)alal-leal 
your Raspberry Pi Zero W to an 
HDMI display 


Mouse and keyboard 

You can either connect your mouse to a 
USB socket on your keyboard (if one is available), 
then connect the keyboard to the micro USB 
socket (via the micro USB to USB-A adapter). 

Or, you can attach a USB hub to the micro USB 

to USB-A adapter. 





More connections 

Now connect your full-sized HDMI cable 
to the mini-HDMI to HDMI adapter, and plug the 
adapter into the mini-HDMI port in the middle of 
your Raspberry Pi Zero W. Connect the other end of 
the HDMI cable to an HDMI monitor or television. 


Yi RASPBERRY Pi mvdiegeit ale fui 


SE 


Pa % 
ia oe 

Vida al-m a al(ol gers) Dior-| ge 
TU LUMAlals(>)aK-Lemmexe) alal=reil 
WelU lm ele). /{=1m-16] 0) e]\ymer-]e)K=) 
to Raspberry Pi. A red 
fe ]alm\ di nar-\e) et=-lme)amaal= 
loXey=| ce MKon [avel(or-\k-mnal=) 
presence of power 


First, insert your microSD 
card into Raspberry Pi 


the software 


Choose OS 
Click on ‘Choose 
OS’ in Raspberry Pi Imager 











and select Raspberry Pi s cA ee 
Use Imager to install Raspberry Pi OS OS (32-bit). Click ‘Choose 
on your microSD card and start your riealaniud a th 
microSD card you just > ie > | 
Raspberry Pl inserted (it should say 8GB | ~~ | 
or the size of the card next | a is ote eS ‘ 
to it). Click on ‘Write’. —— x | 
ow you’ve got all the pieces together, it’s Your computer will take a —— rs 


time to install an operating system on 

your Raspberry Pi so you can start using 
it. Raspberry Pi OS is the official software for 
Raspberry Pi, and the easiest way to set it up on 
your Raspberry Pi is to use Raspberry Pi Imager. 





few minutes to download 

the Raspberry Pi OS files, 

copy them to the microSD card, and verify 
that the data has been copied correctly. 





— You'll Need 
; A Windows/Linux 
Set up Raspberry Pi PC or Apple Mac 
3 When Raspberry Pi Imager has finished computer 


Download Imager 

Raspberry Pi Imager is available for 
Windows, Mac, and Linux computers. You can 
also install it on Raspberry Pi computers, to make 
more microSD cards once you are up-and-running. 
Open a web browser on your computer and visit 
magpi.cc/imager. Once installed, open Imager and 
plug your microSD card into your computer. 


verifying the software, you will get a notification 
window. Remove the microSD card and put it in 
your Raspberry Pi. Plug in your Raspberry Pi power 
supply and, after a few seconds, a blue screen will 
appear with ‘Resizing Filesystem’. It will quickly 
vanish and be replaced by ‘Welcome to Raspberry 
Pi’. Click on Next and follow the on-screen 
instructions to set up Raspberry Pi OS and start 
using your new computer. 


A microSD card 
(8GB or larger) 


A microSD to 
USB adapter (or 
a microSD to 
SD adapter and 
SD card slot on 
your computer) 


Imager 
magpi.cc/imager 
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Raspberry Pi 


An all-in-one system, Raspberry Pi 400 
Is the only desktop you need 


it contains an entire personal computer. 


W hen is a keyboard not a keyboard? When i Raspberry Pj AOO packs g 
On the surface, Raspberry Pi 400 marks measurable Speed boost OVeT 





a return to the early days of personal computing, 


j N 

when bedroom programmers and office staff Rds D D erry P| 4 C= eo — 
plugged all-in-one keyboards directly into their TVs « «Re 
and monitors for everything from gaming to coding. tan 

Raspberry Pi 400 packs a measurable speed boost ™ 
over Raspberry Pi 4, thanks to a clever passive me ani ae | 
cooling system which offers enough i Ye b 
headroom for a processor eat . £ > qv 
— oe : ee Ae i 

Z. | : 

Join us as we dive into —— \—*. ( e 


the latest, and most 


impressive, Raspberry Pi : ? ) 
ever made. i 4 Q “<< De 
' 4 





Personal 
Computer Kit 


You can buy Raspberry Pi 400 on its 
own, or as part of a Personal Computer 
Kit bundle with all the accessories you 
need. Inside the box you'll find: 

> Raspberry Pi 400 computer 

> USB mouse 

> Power supply 

> microSD card 

> HDMI cable Raspberry Pi 400 


> Beginner's Guide book computers being built [it aimee 
Tan talomeie)a\yareoikolavalal * 4 
Pencoed, Wales 
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PLALES IU BUY 


UK & Ireland 


The Pi Hut 


@rrinut thepihut.com 








Raspberry Pi 
Store CPC 
magpi.cc/retail-store cpc.farnell.com 
; OKdo P|IMORONI Pimoroni 
voaTwen® §$okdo.com ores NImMoroni.com 
North America 
‘. a = 
a Qe odo 9Kdo PiShop.us PiShop.us 
es : omTawene §Ookdo.com pishop.us 
» % qe ay 
q nee _— 4 qr 
8 Ye. x ~ te. _ Adafruit ~ Newark 
” Yo, x .~ a. jadafruit 2 qafruit.com elementis newark.com 
ae 4 a 4 es *, ; i 
Ca Pam. “.. ere K > meaocnsa MicroCenter ¢9..4° Canakit 
' a * ry " \ . Maren ster microcenter.com Honk maninden  Canakit.com 
ow + oe S . ve ae 
f NL Ss «0 ee x * vigl 
q \ i . % | 


n 7 > “s r . BuyZero 
ai, S oe * eee at | Eu rope azo buyzero.de 

pe , ~ . . - OKdo r Sertronic 
at : S eS OKco okdo.com digitec.ch 








aw a wi SEMAF 
: | "ba aiwi@peicvoncs KIWH Electronics... tectronics 
, ‘ ww pe kiwi-electronics.nl electronics.semaf.at 
ss Kubii Pi-Snor.cn Totonic 
vunil kubii.fr . pi-shop.ch 
Melopero adoeratii Electrokit 
nelapere melopero.com electrokit.com 
-23q pi3g . Jkollerup 
p | . J pi3g.com eens raspberrypi.dk 
Asia 
siement. @lementl4 eae Cytron 
elementi4.com cytron.io 
RS JUN Hangzhou Junroc 
rs-online.com kh = junroc.com 
sven Silverline sae Beijing iVision 


& 


silverlineelectronics.in ‘®"®®©°"  jvision-tech.world. 
taobao.com 


For a full list of approved resellers, please go to rpf.io/products 
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Feature 


n the first inspection, Raspberry Pi 400 

is deceptively similar to the Raspberry Pi 

keyboard and hub. The rear of Raspberry 
Pi 400 tells a different story, with an array of 
sockets and connectors. Inside Raspberry Pi 400 
is hardware based upon Raspberry Pi 4, but witha 
different design to reposition all the connections. 


£65 / $70 (Raspberry Pi 400), 
£93.00 / $100 (Raspberry Pi 400 
Personal Computer Kit) 


Broadcom BCM2/11CO 
guad-core A72 (ARMv8-A} 
64-bit @ 1.8GHZ 


Broadcom VideoCore VI 
4GB LPDDR4 SDRAM 


2.4GHz and 5GHz 
802,.11b/g/n/ac wireless LAN, 
Gigabit Ethernet 


Bluetooth 5.0, Bluetooth 
Low Energy (BLE) 


A40-pin GPIO header, populated 
microSD 


1x USB Type-C power input, 
2x micro-HOMI 2.0, 1x USB 2.0, 
2x USB 3.0, 1x RJ45 Ethernet, 
1x Kensington locking slot 


Built-in passive heatsink 


2b6mm x 122mm x 
Vac aii ii fesiets) 6 
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The 40-pin GPIO header is used to connect Raspberry 

Pi 400 to electronic devices and to experiment with 
electronics and coding. Look closely and you'll see PIN1 and 
PIN40 imprinted on the case next to the first and last pin 





Two USB 3.0 sockets are used to 
connect devices to fast throughput, 


such as external storage drives A single USB 2.0 socket can be 
used with the mouse 





Se 





- 





This push-click microSD socket acts as 
the main drive. A 16GB microSD card 
with Raspberry Pi OS pre-installed is 
included in the Personal Computer Kit 





Gigabit Ethernet 
provides a fast direct 
network connection 





feature 





Raspberry Pi 400 is powered via 
this USB-C Power connection using 
a Raspberry Pi 15.3\W USB-C Power 


Two micro-HDMI connectors are 
Supply (also included) 


used to connect Raspberry Pi 400 
to up to two 4K monitors 


Secure Raspberry Pi 400 to a table 


with the security lock socket 4 


Raspberry Pi 400 has the same 40-pin GPIO header as all current 
Raspberry Pi models. Only now it’s positioned on the rear of the case. 
You can connect HAT hardware directly to the 40-pin GPIO header, but it 
will be pointing backwards and down. A ribbon cable can be used to extend 
the GPIO pins and most will connect to Raspberry Pi 400 and extend with 
the pins facing upwards. You can pick up ribbon cables from The Pi Hutand | 
other stores for around £3. Here we're using a 40-Pin GPIO Ribbon Cable - AY 
Rainbow 150 mm from The Pi Hut (magpi.cc/ribboncable). ; 





es fealure | INTRODUCING RASPBERRY PI 400 





Eben Upton and 


Simon Martin on 
Raspberry Pi 400 


Raspberry Pi Foundation founder Eben Upton and principal hardware 
engineer Simon Martin wax lyrical about the new product 


Foundation founder Eben Upton enthuses 

of Raspberry Pi 400’s birth. “Every now 
and then we do a product which brings together 
everything that we’ve learned, about technology 
and about business. Raspberry Pi 400 is another 
one of those summary products. 

“T think it’s important to make beautiful 
things, and it’s just beautiful. It’s designed to be 
an object of desire. It just looks great. 

“It’s faster than Raspberry Pi 4, and it’s 
thermally a lot better because it’s got more space 
and there’s some clever passive thermal design. 
So, although it runs 20% faster, it runs a lot 
cooler. That’s cool, but really, for me, it’s just the 
feel of it in your hand, the weight. It just feels like 
a consumer product, and it’s the first time we’ve 
ever made anything that’s like that.” 


ad t’s the most exciting product,” Raspberry Pi 


What's in ag name? 


“Somebody asked me,'ls it named after the Atari 400?" | mean,” Eben explains, 
“it's a nod to the ‘three-digit number that ends In zero’ as a pretty common 
naming convention with Atari, both 8-bit and 16-bit with the 520, Amiga with 
various hundreds, Acorn with the Archimedes 3055, 3105S, 440s, yeah. It was a 
fe)a=anvacexe)aalaate)amal-laaliale mexola\-ralsielar 

“It is obviously appealing that if, in the far future, we do a Raspberry Pi 5, then a 
Raspberry Pi 5 version will be called Raspberry Pi 500, which as an Amiga person 
sme [UliKomalloicy 

“It gives you a natural extension of the name scheme: we can still do plus 
models, we can still do major revisions, and it preserves the ‘if you don't know 
anything about Raspberry Pi, get the largest number you can see’ rule.” 
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A_ Eben Upton, creator of Raspberry Pi and 
founder of Raspberry Pi Foundation 


Project Gamma 

“T was hired at Raspberry Pi to do just sucha 
product, back in summer 2017,” Raspberry Pi 400 
designer Simon Martin explains. “At the time, 
Raspberry Pi 3 was the thing and I set about 
making a ‘Raspberry Pi 3 in a keyboard’ product. 


M | think it's important to 
make beautiful things, and 
it's Just beautiful @ 


“The project was called the Commodore 64 
Project, and I thought, ‘Well, it’s a bit risky calling 
something the Commodore 64 Project, because 
everybody knows what we’re doing!’ So I took 
the letter C, in C64, and replaced it with Project 
Gamma, as in alpha, beta, gamma. 


“Tt was clear it was going to be ready in 
production after Raspberry Pi 4 was announced, 
so we decided to move to Raspberry Pi 4. It was 
February last year I started work on making this 
Raspberry Pi 4-based Raspberry Pi 400 product.” 


Keeping cool 

“T spent about six months working on the thermal 
side of it,” Simon continues. “That was the key 

to getting this thing to be a successful product: 

to make something that didn’t need any external 
cooling, it was going to deal with it itself. So, I 
spent a lot of time doing a thermal solution for it, 
and we came up with this metalwork inside it. 

“Tf you see inside one, there’s a metal plate 
that runs across the entire board and keeps 
everything cool. I involved some consultants in 
thermal design, and they said that if the power 
consumption was, Say, under 10 watts, thena 
passive cooling solution would be possible. 

“Sure enough, there were some improvements 
to power draw that went on with Raspberry 
Pi 4 before it was announced, getting it down 
to the sort of 6 to 7 watt level. All of those 
improvements have kept the power budget toa 
useful level such that we can overclock Raspberry 
Pi 400 to 1.8GHz.” 
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Simon Martin, Senior Principal Hardware Engineer at 
Raspberry Pi and designer of Raspberry Pi 400 
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MS Juicrial | GET STARTED WITH THE HIGH QUALITY CAMERA 


Get started with the 
High Quality Camera 


Find out how to set up the new Raspberry Pi camera, 
connect it, and take your first shots and videos 





Phil King 





Phil is Raspberry 
Pi Press's books 
editor, as well as 
being a sub-editor 
and contributor for 
The MagPi. 


magpi.cc 


You'll Need 


>» Raspberry Pi High 
Quality Camera 
and lens 
magpi.cc/hqcamera 


(HQ Camera for short) can capture higher- 
resolution images than the standard 
Camera Module. Unlike the latter, it doesn’t have 

a lens already attached. Instead, it can be used 
with any standard C- or CS-mount lens; 6mm and 
16mm lenses are available to purchase with the 
camera to help you get started. 

In this tutorial, we’ll show you how to attach 
a lens to the HQ Camera and adjust its focus and 
aperture settings. We’ll then use the supplied 
ribbon cable to connect it to Raspberry Pi, enable 
it in Raspbian, and enter some commands ina 
Terminal window to start capturing photos 
and video. 


T he new Raspberry Pi High Quality Camera 


Using the 6mm 
CS-mount lens 


A low-cost 6mm lens is available for the 

HQ Camera. This lens is suitable for basic 
photography. It can also be used for macro 
photography because it can focus objects at very 
short distances. 
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Fit the lens to the camera 

The lens is a CS-mount device, so it has 

a short back focus and does not need the C-CS 
adapter that comes with the HQ Camera. Rotate 
the lens clockwise all the way into the back focus 
adjustment ring. 





~N 
cs 





Back focus adjustment ring 

The back focus adjustment ring should be 
screwed in fully for the shortest possible back- 
focal length. Tighten the back focus lock screw to 





make sure it does not move out of this position 
when adjusting the aperture or focus. 





Adjust aperture 

Hold the camera with the lens facing away 
from you. Turn the middle ring while holding 
the outer ring, furthest from the camera, steady. 
Turn clockwise to close the aperture and reduce 
image brightness. Turn anti-clockwise to open the 
aperture. Tighten the screw to lock the setting. 





Adjust focus 

First, lock the inner focus ring, labelled 
‘NEAR @> FAR’, in position by tightening its 
screw. Now hold the camera with the lens facing 
away from you. Hold the outer two rings of the 
lens and turn them both clockwise until the image 
comes into focus — it’ll take four or five whole 
turns. To adjust focus, turn the outer two rings 
clockwise to focus on a nearby object. Turn them 
anti-clockwise to focus on a distant object. You 
may need to adjust the aperture again after this. 
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1. The dust cap should be used when a lens 
is not attached, as the camera sensor is 
sensitive to dust 





4. This enables you to mount the camera 








2. Supplied with the camera, the C-CS on a standard tripod 
adapter should be used when attaching 
a C-mount lens 5. The camera is supplied with a 20cm ribbon 
cable to connect It to Raspberry Pi's 
3. The back focus adjustment ring can be used Camera port 
to alter the focus when using a fixed-focus 
lens, or to change the focal range of an 6. Tighten this screw to lock the back focus 
attached adjustable-focus lens adjustment ring in position 
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TopTip @& 


Longer cable 


The HQ Camera 
is supplied with 
a standard 20cm 
ribbon cable for 
connection to 
Raspberry Pi. 
However, longer 
camera cables 
are available 
from the usual 
online retailers. 








Using the 16 mm 
C-mount lens 


The 16mm lens provides a higher-quality image 
than the 6mm lens. It has a narrow angle of view 
which is more suited to viewing distant objects. 





Fit the C-CS adapter 


Ensure the C-CS adapter that comes with 
the HQ Camera is fitted to the lens. The lens isa 


C-mount device, so it has a longer back focus than 


the 6mm lens and therefore requires the adapter. 





eo) 


Fit the lens to the camera 
Rotate the lens and C-CS adapter clockwise 
all the way into the back focus adjustment ring. 
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Back focus adjustment ring 

The back focus adjustment ring should be 
screwed in fully. Tighten the back focus lock screw 
to make sure it does not move out of this position 
when adjusting the aperture or focus. 





M Tighten the back focus lock 
screw to make sure 
it does not move out of 
this position @ 





Adjust aperture 

To adjust the aperture, hold the camera 
with the lens facing away from you. Turn the 
inner ring, closest to the camera, while holding 
the camera steady. Turn clockwise to close the 
aperture and reduce image brightness. Turn anti- 
clockwise to open the aperture. Once you are 
happy with the light level, tighten the screw on 
the side of the lens to lock the aperture ring 
into position. 





Adjust focus 

To adjust the focus, hold the camera with 
the lens facing away from you. Turn the focus ring, 
labelled ‘NEAR 4 FAR’, anti-clockwise to focus 
on a nearby object. Turn it clockwise to focus ona 
distant object. You may find you need to adjust the 
aperture again after this. 


Connecting and 
using the camera 


With your HQ Camera and mounted lens ready, 
it’s time to connect it to your Raspberry Pi and 
Start capturing some images. 


Connect ribbon cable to camera 

On the bottom of the HQ Camera board, 
you’ ll find a black plastic flap (Figure 1). Carefully 
pull the sticking-out edges until the flap pulls 
part-way out. Slide the ribbon cable, with the 
silver edges downwards and the blue plastic facing 
upwards, under the flap you just pulled out, then 
push the flap gently back into place with a click; 
it doesn’t matter which end of the cable you use. 
If the cable is installed properly, it will be straight 
and won’t come out if you give it a gentle tug; if 
not, pull the flap out and try again. 


Connect cable to Raspberry Pi 

Find the Camera port on Raspberry Pi 
and pull the plastic flap gently upwards. With 
Raspberry Pi positioned so the HDMI port is facing 
you, Slide the ribbon cable in so the silver edges are 
to your left and the blue plastic to your right, then 
gently push the flap back into place. As before, if 
the cable is installed properly, it’ll be straight and 
won’t come out if you give it a gentle tug; if not, 
pull the plastic flap out and reinsert the cable. 
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If using a Raspberry Pi Zero, its Camera port 
is found on the edge of the board. However, as 
it’s a smaller size than the regular one on other 
Raspberry Pi models, you’1]1 need a camera adapter 
cable to use it (magpi.cc/zerocamcable). 


Enable the camera 

Connect the power supply back to Raspberry 
Pi and let it load Raspbian. Before you can use 
the camera, you’ll need to tell Raspberry Pi it 
has one connected: in the Raspbian menu, select 
Preferences, then Raspberry Pi Configuration. 
When the tool has loaded, click the Interfaces tab, 
find the Camera entry in the list, and click on the 
round radio button to the left of ‘Enabled’ to switch 
it on (Figure 2, overleaf). Click OK, and the tool will 
prompt you to reboot your Raspberry Pi. Do so and 
your camera will be ready to use. 


Test the camera 

To confirm that your camera is correctly 
installed, you can use the raspistill tool. This, along 
with raspivid for videos, is designed to capture 
images from the camera using Raspberry Pi’s 
command-line interface (CLI). In the Raspbian 
menu, select Accessories, then Terminal. A black 
window with green and blue writing in it will 








Figure 1 


TopTip @& 


Permanent 
preview 


To keep the 
preview window 
showing on 
screen, then take 
a photo whenever 
the ENTER key 

is pressed, use 
this command: 
raspistill 

-t @ -k -o 
my_pics%@2d. jpg. 
Press CTRL+C 

to exit. 
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TopTip @ 
Using VNC 


By default, you 
won't be able to 
view the camera 
preview window 
when accessing 
your Raspberry 

Pi remotely from 
another computer 
via VNC. However, 
there is a setting 
to make the 
window appear. 
Open the VNC 
Server menu on 
Raspberry Pi and 
go to Options > 
Troubleshooting, 
then select 
‘Enable direct 
capture mode’ 
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appear: this is the Terminal, which allows you to 
access the command-line interface. 

To take a test shot, type the following into 
the Terminal: 


raspistill -o test.jpg 


As soon as you hit ENTER, you’ll see a large 
picture of what the camera sees appear 

on-screen (Figure 3). This is called the live 
preview and, unless you tell raspistill otherwise, it 
will last for five seconds. After those five seconds 
are up, the camera will capture a single still 
picture and save it in your home folder under the 
name test.jpg. If you want to capture another, 
type the same command again — but make sure to 
change the output file name, after the -o, or you’ 11 
save over the top of your first picture. 




















Figure 2 


Figure 3 
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More advanced commands 

The raspistill command has a list of options 
so long that it borders on the intimidating. Have no 
fear, though: you won’t need to learn them all, but 
there are a few that might be useful to you, such as: 





raspistill -t 15000 -o newpic.jpg 


The -t option changes the delay before the picture 
is taken, from the default five seconds to whatever 
time you give it in milliseconds — in this case, you 
have a full 15 seconds to get your shot arranged 
perfectly after you press ENTER. 


Capture video 
For shooting video, raspivid is what you 
need. Try it out with this Terminal command: 





raspivid -t 10000 -o testvideo.h264 


This records a ten-second video (10,000 milliseconds) 
at the default 1920 x 1080 resolution. You can also 
shoot slow-mo video at 640 x 480 by using: 


raspivid -w 640 -h 480 -fps 98 -t 10000 -o 
test90fps .h264 


You can use VLC to play the videos back. This 
application is pre-installed in the Raspbian ‘Full’ 
version. If it’s not, you can use the Recommended 
Software tool to install it. 7 
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Project Showcases 





RadioGlobe 
This globe rotates and plays a radio 
station for the selected location 


WeatherMan 
A classic Sony Walkman upcycled into 
a weather-predicting smart device 


Pi Commander 
Converting an old electronic toy 
into a retro games machine 


Oktoberfest Pinball Machine 
By the power of Raspberry Pi, you 
can play real pinball online 


Astrophotography 
Autoguider 
Keep your telescope steady to take 
perfect pictures of the night sky 
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Hot Spotter 
An autonomous drone that can detect 
and report smouldering fires 


Aquatic Mini 
Observation System 
This solar-powered, autonomous boat 
measures water quality 


Airdrum 
This drum kit can be played with a 
hover of your hands 


Cheeseborg 
A dedicated, hands-free grilled 
cheese making robot 


Bit Time — Rotary 

Dial Phone Project 
Using two upcycled retro phones to 
explore how people communicate 


NeoPixel LED Mirror 
A magic mirror that shows you your 
reflection in LEDs 


AdventurePi 
Portable arcade project lets you 
choose your own adventure 


Reachy 
Meet the expressive and flexible open- 
source robot 
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68 El Carrillon 
Hacking the bells of an enormous 
tower to ring the changes 


72. Bellagio Water Show 
This miniature fountain features water 
Jets synchronised to music 


74 Raspberry Pine 
The desktop computer with a wooden- 
framed display 


76 Instaclock 
A unique digital clock using two Raspberry 
Pi computers and screens 


80 CNC Etch-A-Sketch 
Using rotary encoders to control the 
knobs on a classic drawing toy 


82  Solar-powered Raspberry Pi 
Camera 

This ingenious home CCTV system is 

powered by the sun 


84. Flying Saucer Clock and NAS 
An out-of-this-world way to tell the 
time and store your files 


86 Chamber: Sourdough 
Incubator 

Regulate the temperature of your 

sourdough starter 


88 DropStitch 
Creating amazing embroidery 
with wireless file transfer 


90. ‘RioT Brick 
Track a runner's progress with 
this portable sensing station 


94 HAL 9000 Google Assistant 
A voice assistant with the looks 
and personality of a film star! 


98 Apollo Pi 
Thermal sensing camera disguised 
as a 1970S microwave scanner 


102 BeeMonitor 
Keeping an eye on bee life cycles 
with Raspberry Pi 


104 Giant Battleships 
Play the classic board game ona 
giant LED matrix 





106 Coffee Maker ‘Greenhouse’ 
Upcycle an old coffee maker to 
irrigate pot plants 


108 Piano-Playing Robot 
It can play scales, chords, and tunes 
and even read sheet music 


110 Singing Toilet 
A chotr of loo rolls start singing when 
the paper Is pulled 


112 Migration Museum 
Celebrating the diversity of London's 
residents with interactive artefacts 


116 Project Zed 
Sci-fi inspired robot made from old 
printer parts 


120 PiMowBot 


Raspberry Pi-powered robotic lawn-mower 


124 Retro gaming NES frame 
Displaying pixel art on an old 
game cartridge 


126 Black Lives Matter projection 
Thought-provoking video projection 
powered by Raspberry Pi 


130 The Swirl Machine 
Make fantastic art by spinning and 
sloshing wine 
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RadioGlobe 


Want to know what's playing on the radio anywhere In 
the world? Rob Zwetsloot goes on tour with RadioGlobe 





Jude Pullen 





Self-proclaimed 
‘prototyping expert’ 
and ‘technologist’ 
with an impressive 
resume of work 
designing concepts 
for Dyson, Sugru, 
Lego, DesignSpark, 
and even TV. 


magpi.cc/ 
radioglobe 





Alert! Drill safety 


Please use safety 
goggles and a desk 
clamp when drilling. 


magpi.cc/drillsafety 


projects online. Why make something that 

already exists in an easier format, or isn’t very 
functional? The simple answer is: because we can. It 
can be very fun to make stuff, and the RadioGlobe is 
an excellent example of this. 

“It’s a globe which you spin to search web radio 
stations,” creator Jude Pullen summarises. “It’s 
really simple to use (even my four-year-old son gets 
it!), but the tech inside is pretty clever to make it 
work. It has a very special component called a rotary 
encoder, which has the ability to know the position of 
a rotating axis (in this case the longitude and latitude) 
to an accuracy of 0.3 degrees. It means we can 
navigate to all the major cities in the world and listen 
to their local stations.” 


p eople sometimes ask us ‘why?’ when we share 





Bringing radio to life 

The idea for the project arose through a combination 
of concepts that were on Jude’s mind at once. “I 
think I’d been reading books about space travel, and 
the emergence of communications while working 

on a Channel 4 show called David Jason’s Great British 
Inventions,” he says. “My job was to build a replica of 
the Bell telephone (using some scrap wood, piping, 
wires, tracing paper, and vinegar! ), and it kinda blew 
my mind to consider the advent of this technology in 
the world. This led me to explore a lot of technology 
we take for granted, like radio. I was discussing this 
with a friend who then mentioned a website called 
RadioGarden [radio.garden] which allows you to look 
up all radio stations on Google Earth. It’s a clever 
mash-up of two powerful technologies, and I guess 
my ‘build’ on this was to make it physical.” 
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Jude usually works 
with Arduino, but 
Raspberry Pi was 
more Suited to 

this project 


The basic design 
was created in 
cardboard first... 


.. before being 
3D-printed in Jude's 
home workshop 


Jude's friend Don 
Robson helped with 
the code 


The rotary encoders 
remember where 
they are when you 
next turn it on! 


aM al=me|Kolol-m-je)lal-m [eras 
like a toy version! 
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Just a few of the 
tools and items you 
need to build such 
a device 


A Raspberry Pi and 
all the other main 
electronics are 
stored in the base 
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Proof is in the concept 
The world is a big place — Jude tells us there are 
44,000 radio stations around the world, and not 
all of them have great broadcast quality. For 
what he’s managed to achieve, he seems pretty 
happy, though. 

“There is a phrase in design called ‘proof 
of concept’ or in code it’s sometimes called 
‘minimum viable product’,” he notes. “RadioGlobe 
is that in terms of its physical design (3D-printed) 


MWe can navigate to all the 
major cities in the world and 
listen to their local stations @ 


and code (V1.0 on GitHub). It works really well 
in that most of the 2000-odd radio stations do 
play, but yes there are bugs — in that some radio 
Station links are in countries where broadcast is 
not perfect, so this can ‘trip up’ the code, and it 
stops playing.” 

Jude has some updates in the works for the 
RadioGlobe, some of which sound fairly obvious 
and genuinely useful, such as a recall function 
for favourites in case you stumble upon a K-pop 
Station you really like, as well as a Shazam button 
to identify the latest Austrian hit. 
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Find a radio station 


01 Spin the globe - this is your longitude 
control - to get to a rough area. Then use 
the arm to centre the reticule on an exact location. 
A light will turn from flashing white to red when it's 
got a location. 


eae iy 





A The electronics 
are hidden from 
the top but visible 
from below 






\ i 


<0 Final adjustments : cS os , “4 
: i i 
02 Two rotary encoders are used to determine 
the position of the reticule on the globe (that 
Longitude and latitude again), which checks against 


locations. This turns the light to red when it syncs up 
with somewhere with playable radio stations. 


51. SH; A. ib 
London, UK 


BBC Radic 





03 You can scroll through a list of stations at the 
location, but otherwise it will display what the 
station is on the screen and start playing from it. 
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“This is possible because the project is open 
source, and the code can be contributed to be total 
strangers from around the world,” Jude explains. 
“T love the poetic-loop of this! And this has very 
much been the best of my experience in working 
with exciting companies like DesignSpark and 
Raspberry Pi who have championed new ideas that 
literally might come from anyone, anywhere in the 
world. Perhaps we’ll have RadioUniverse one day! I 
joke, but of course RadioGlobe would have seemed 
crazy 100 years ago too.” fi] 






A Attaching the 
globe is one of 
the final steps 







<4 Some 
modification 
of the globe 
is required 









V We'll excuse Jude 
for saying it’s 
“child's play” to 
use because, well, 
he's right 

















30 | The Official Raspberry Pi Handbook 2021 


A\gale)p 


Ol ) 


The Argon ONE M.2 Case ups the ante 
by providing Two full-sized HDMI ports, 
Power Management Modes, Built-in 

IR support, Integrated M.2 SATA SSD 
10) 0) ofo) a midalcolele|aMuat-MOls) = BCR ON ne) at-He)) 


STRIKE Ay TACK TR rf Raspberry Pi 4. 


Coolest Cases. 
Fastest Raspberry Pi ever. 


~~ a 


POLY+ y\ =e @) NE =e) y\ =e @) \ ie) = ARGON PI NAS 
W/ MINI FAN PI4 V2 (ere) ¥,  Nem—lere ND) 


| Raspberry Pi Wp TAA SLESIAL®) OM eLo Rr Z- 


Reese RESELL ER 








32 


Martin 
Mander 


Martin works in 
the Intelligence 
& Analytics 
Department at 
Norfolk County 
Council. He's 
passionate about 
giving old tech 

a new lease of 
life, especially 
projects involving 
Raspberry Pi. 
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A shiny music box with go clear door for a screen proves an ideal 
Upcycling candidate for an eighties tech fan keen to keep tabs 
on the weather, Rosie Hattersley hears more 


artin Mander is no stranger to 

repurposing outdated tech. “I! started 

converting and upcycling vintage 
technology about ten years ago, after a brief stint 
blogging for Wired’s GeekDad column,” he tells 
us. Discovering he enjoyed documenting projects 
as much as building them, he began specialising in 
giving new purpose to broken old tech - “especially 
items I remember being ‘the latest thing’ during 
the 1970s and 1980s when I was a child.” 

Martin became enamoured of all things 
Raspberry Pi-flavoured in 2014. Looking for a one- 
box alternative to a PC for converted gadgets, he 
was tipped off by a reader that Raspberry Pi might 
work. He duly made a Raspberry Pi- powered VCR. 
Numerous ‘fruitful’ projects followed. There’s now 
a sizeable archive at magpi.cc/oldtechprojects. 
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The Walkman, of course, fits that description 
to a tee. Sony alone sold 200 million, while other 
brands of cassette player were also legion. 


| immediately fell in love 
with it... It had a great 
retro look 


Press play 
Martin’s chance to ‘rescue’ one came when his 
mother-in-law sent him a broken old Hitachi 
player that she found during a clear-out. 

“T immediately fell in love with it,” Martin 
recalls. “It had a great retro look that drew me in”. 
On closer examination he realised the window in 


WEATHERMAN | Project Showcae 


At the first sign of rain, 
bY, Kare 1d al=19 tela om alcrelel elale)al=s 
begin to jiggle 


The more likely it is to rain, 
dal=magte)aomlle|aiace-le-m lime a 
the LED matrix, which also 
shows the temperature 
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Martin's first tech 
encounter was 
with a BBC Micro 
at school 


> He half expected 
singers to appear 
if music cassettes 
were used with it 


Martin's home 
has 25 Raspberry 
Pi devices for 
both security and 
entertainment 
duties 


He has a ‘lovely 
but trashed’ 
1960s Dansette 
radio ripe for 
conversion. 


Key attraction: 

it perfectly 
matches the 
colour scheme in 
his bathroom 


I'd been looking for ad small case to hold a 
weather display for my desk for ad while @ 


the cassette player’s door was — to the millimetre 
— the same size as a Raspberry Pi HAT. “At that 
point, all my other projects hit the back burner,” 
he says. 

“Td been looking for a small case to hold a 
weather display for my desk for a while, and this 
was the perfect thing. I also had an unused Unicorn 
HAT HD lying around and this seemed like the ideal 
project for it.” To this he added servos and an awful 
lot of Sugru — a sort of malleable glue. 
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The early 1980s-style 
ambient loT weather 
display has a current 
conditions animation 


“In the past I’ve used Lego and Meccano to put 
things together, but with space being so tight in 
the case, I used Sugru this time around. It’s very 
workable but sets hard like plastic, perfect for 
fixing components in the right place.” 

The WeatherMan currently relies on API data 
from the Dark Sky weather service, but Martin 
eventually hopes to link it up to a Raspberry Pi 
weather station. “With a Raspberry Pi at each 
end, it should hopefully be straightforward!” he 
Says optimistically. 


Getting the details right 

The main aim for what became the WeatherMan 
project was to keep the exterior as true as possible 
to the original. He wanted it to look like an 





A Helpfully, a Raspberry Pi 
Unicorn HAT Is precisely 
the same size as the 
cassette player's 
display window 


<< Diagram showing the 
relatively simple setup 
involved in creating the 
WeatherMan project 





ornamental piece sitting on his desk speaker, 
hiding a useful loT (Internet of Things) device until 
it bursts into life. 

Martin thought the tape player seemed a bit 
naked without the iconic eighties headphones, 
so he looked for ways to incorporate them into 
the build. He drilled out the original jack plug and 
fittings and joined them together using a2mm 
threaded rod. With a small nut on each end of 
the rod and a servo connector at the bottom, the 
headphones now respond whenever the weather 
is about to change. Their servo-controlled jiggling 
always makes Martin smile, even if it’s to alert him 
rain is on the way. Hl 
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Make your own WeatherMan 








Dismantle the cassette player to create as 
much space as you can inside. Retain any 
parts you want to reuse. You may need to trim down 
the case inside to make the components fit nicely. 


You may need new bolts or a tiny magnet to 
make the cassette tape door close properly 
once you've tinkered inside. When you're satisfied 
that it works well, hot-glue the cassette player 
case and door. 


Dark Sky API 


The eachest, most achvanced, weather APT on the web, 





Easy to Use Weather Conditions Advanced Data 


@ & =, 


Use Raspbian Buster and adapted Python 
scripts to retrieve weather data from Dark Sky, 
display info on the Unicorn HAT, and (optionally) 
jiggle the headphones. Scripts and a ReadMe are on 
GitHub at magpi.cc/ghweatherman. 
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TS) Project Showcase | P| COMMANDER 





P1 Commander 


Adrien Castel's deg of converting an old electronic toy into gd retro 
games machine was no flight of fancy, as David Crookes discovers 








Adrien Castel 


Adrien is an IT 
technician and 
graphic designer 
specialising in 3D 
and VFX. He lives 
in France and loves 
building stuff that 


involves electronics. 


magpi.cc/ 
picommander 


The games can 
make use of the 
full screen. Adrien 
would have liked a 
larger screen, but 
the original ratio 
oddly lay between 
4:3 and 16:9, making 
a bigger display 
harder to find 


electronic toys. Children would pester their 

parents for a Tomytronic 3D or a Nintendo 
Game & Watch. And they would enviously eye 
anyone who had a Tomy Turnin’ Turbo Dashboard 
with its promise of replicating the thrill of driving 
(albeit without the traffic jams). 

Two years ago, maker Matt Brailsford turned that 
amazing toy into a fully working Out Run arcade 
machine and Adrien Castel was smitten. “I loved 
the fact that he’d upcycled an old toy and created 
something that could be enjoyed as a grown-up,” 
he says. “But I wanted to push the simulation a 
bit further and I thought a flying sim could do 
the trick.” 

Ideas began flying around Adrien’s mind. “I 
knew what I wanted to achieve so I made an overall 
plan in my head,” he recalls. First he found the 
perfect toy: a battery-powered Sky Fighter F-16 
tabletop game made by Dival. He then decided to 


T he 1980s was a golden era for imaginative 
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base his build around a Raspberry Pi 3A+. “It’s the 
perfect hardware for projects like this because of 
its flexibility,” Adrien says. 


Taking off 
The toy needed some work. Its original 
bright red joystick was missing and 
Adrien knew he’d have to replace the 
original screen with a TFT LCD. To 

do this, he 3D-printed a frame to 

fit the TFT display and he created a 
smaller base for the replacement 
joystick. Adrien also changed the 
microswitches for greater sensitivity 
but he didn’t go overboard with the changes. 

“T knew I would have to adapt some parts for 
the joystick and for the screen, but I didn’t want to 
modify the look of the toy,” Adrien explains. “To 
be honest, modifying the toy would have involved 
some sanding and painting and I was worried that 
it would ruin the overall effect of the project if it 
was badly executed.” 

As such, a challenge was set. “I had to keep most 
of the original parts such as throttle levers and 
LEDs and adapt them to the new build,” he says. 
“This meant getting them to work together with 
the system and it also meant using the original 
PCB, getting rid of the components and re-routing 
the electronics to plug on the GPIOs.” 





> A Raspberry Pi 3A+ sits 
at the heart of the Pi 
Commander, alongside 
a mini audio amplifier, 
and it’s wired up to 
components within the toy 
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PANU Mo) im dat=m ole lace)al-wme) darcy s ™ Games can display in a small 
than the joystick, are ~~ WiTateCo AV GldallawaXela(=)aBs 
original to the toy - as are A ——_—= % custom front end, with the list > Dival's Sky 


the seven red LED lights | —_ of games displayed beneath Fighter F-16 toy 
=f : is repurposed 


| > Its internal 


components 
were desoldered 






















A four-inch 
800x480 HDMI TFT 
screen is used 


Adrien suggests 
trying an 
analogue Joystick 


Games are chosen 
using a Select key 





Adrien was inspired by a real 
F-16 cockpit and created a 
set of cool custom stickers 


| didn't want to modify the look of the toy 


There were some enhancements. Adrien 
soldered a PAM8403 3W class-D audio amplifier 
to Raspberry Pi and this allowed a basic speaker 
to replace the original for better sound. But there 
were some compromises too. 

“At first I thought the screen could be bigger 2 
than the one I used, but the round shape of the \ _ 
cockpit didn’t give much space to fit a screen larger \’ 


than four inches.” He also believes the project Yee A | yy 4 


could be improved with a better joystick: “The one IA | 
I’ve used is a Simple two-button arcade stick with a I irae = oy Wey aye heise «ty ig 
jet fighter look.” 7° ant ae Sete = an e 


= — re 


a 


Flying high 

By using the retro gaming OS Recalbox (based on 
EmulationStation and RetroArch), however, he’s . ad | / c a 
been able to perfect the overall feel. “Recalbox | | , 
allowed me to create a custom front end that 
matches the look of a jet fighter,” he explains. It 
also means the Pi Commander plays shoot-’em- 
up games alongside open-source simulators like 
FlightGear (flightgear.org). “It’s a lot of fun.” 


The original PCB was used and the electronics were re-routed. All the components need to 
work between 3.3 to 5V with the lowest possible amperage while fitting into a tight space 
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SE Project Showcase | OKTOBERFEST PINBALL MACHINE 








Oktoberfest 


Pinball Machine 


Real-life arcade halls may be off-limits, but by the power of Raspberry 
P| you can play real pinball online. Rosie Hattersley flips out 
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Stan 
Dmitriev 


Stan works at real- 
life online games 


company Surrogate. 
tv in Espoo, Finland. 


Their marvellously 
geeky office is 
strewn with more 
than 100 Raspberry 
Pi 4 computers. 


surrogate.tv 


Play the real 
Oktoberfest Pinball 
Machine for free in 
Chrome or Firefox 





any of us dream of having our own games 
room, quite possibly with a pinball machine 
at its centre. Such fantasy comes with a 
rather large price tag, so the idea of being able to 
play a proper pinball machine, albeit via the internet, 
holds a strong appeal. This was the thinking behind 
Finnish company Surrogate.tv, which specialises 

in creating real-life games experiences that can 

be played online. The two-year-old company has 
recently launched its first Raspberry Pi-based pinball 
game, the Oktoberfest Pinball Machine, in which 
players shoot balls to gradually fill a stein of beer 
while an oompah band sings a toast. 


& co 
SURROGATE, 


TOF Fh 8S Prnde 
ALL-TIME j 


i Surrogate.tw/game/oktoberfest 


Real Oktoberfest Pinball - Espoo, Finland 


10572 Views 2 Players in Queue 
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While the theme may seem timely since the 
legendary Munich beer festival ought to be taking 
place in September, Surrogate.tv’s Stan Dmitriev 
tells us that it just so happened this design of 
vintage pinball machine came up for sale while 
they were pondering a Raspberry Pi 4-based 
design. The 20-strong staff of Surrogate.tv are 
“a bunch of gamers and geeks,” says Stan. He 
estimates that there are more than 100 Raspberry 
Pi 4 computers in the office! Some have been 
used to control various robots — one of their other 
offerings is aSumoBot challenge in which real 
sumo robots battle it out in an arena, controlled 


®t #8 O 6 a @ : 


i Players Live Streaming Right howl 


High Score List & Tournament (Ends 336 Shr 


We hope you enjoy! & 
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The oompah- 
accompanied 
Oktoberfest Pinball 
Machine runs 24/7 


Thankfully, it 
lives In a sound- 
insulating cabinet 


On May The 4th 
Day, Surrogate.tv 
launched a Star 
Wars special. 


..Raspberry Pi- 
powered The 
Force Claw 


a al-mero)alice)tcmeo)m-lame)ale|iat-lm elialer=lat | — 
nate \eaallal-mar-\i-m oX-\-lamaecxerelalirelela-te| ‘; ‘i Some multi- 
so it can be played over the internet [99 Raspberry Pi 4 
ail projects are in 
the pipeline 





Project Showcase 





PWM Cooling Fan 


JST-AH SV Input 2 


Surrogate.tv designed 
a Raspberry Pi 4 
arcade game 

HAT for use with 
different types of 
arcade machine 





Alert! 
High voltage 


Be careful when working 
with mains electricity. 


magpi.cc/ 
electricalsafety 
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Getting Raspberry Pi 

to recognise the start 
and end of agame 
centred on how the Start 
button’s LED behaved 
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by players over the internet. However, they’d also 
have a powerful computer on the side to execute 
the ultra-low-latency video streaming part of the 
project stack. 


Flipping fun 

The Oktoberfest Pinball Machine is the first 
project they’ve created in which Raspberry Pi 
handles the whole setup. “Players can control 

the flippers using the left and right CTRL/CMD 
key and can shoot the ball from the plunger 

using the SPACE bar on the keyboard,” explains 
Stan. Webcams provide a live feed of the pinball 
bouncing around inside the machine, with the 
human player responding by hitting the flipper 
buttons to keep it moving and away from the 
danger zone. One webcam shows the action, while 
another shows the current and high scores. “Both 


40 The Official Raspberry Pi Handbook 2021 





these video feeds and the audio feed are combined 
using Raspberry Pi’s compute capabilities, 
encoded into a single compressed video feed 
and sent to the user in near real-time using the 
SurroRTG suite,” he says. 

Like in a real arcade hall, you have to queue 
to play, since you really are playing the actual 
machine. Blinking LEDs on the machine at the 
end of a game are recognised by Raspberry Pi, 
which then invites the next person to play. They 
undertook lots of analysis before realising the 
Start button LED operates in a very specific way 
based on the pinball machine’s state, says Stan. 
“By reading this behaviour and inputting it to 
Raspberry Pi, we managed to solve the challenge.” 


Pinball wizardry 

Their existing online pinball machine, 

Batman ’66, proved very popular, and 

players were asking for more machines. For 

the Oktoberfest machine, they took a more 
streamlined approach than the Batman machine, 
with plans to simplify the process of hooking up 
pinball machines for online play. “We wanted to 
make the setup replicable,” reveals Stan. 
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Single-player mode 
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My 
A 
01 To turn an arcade machine into one 
playable online, download the SurroRTG 
software (it will be a free download launching this 
autumn), install it on Raspberry Pi 4, and navigate 


to surrogate.tv. 





To this end, they designed their own arcade 
machine HAT with eight output switches. 
This Raspberry Pi 4 HAT works with a range of 
arcade machines, including claw ones. It has its 
own cooling fan, as well as dedicated switches 
corresponding to arcade machine controls 


02 Hook up the wires for the flipper and 

control buttons on your arcade machine to 
corresponding pins on your Raspberry Pi, then wire up 
the Start button LED and the ball lane detector sensor. 


M Like in g real arcade hall, you have to 
queue to play, since you really are playing 
the actual machine @ 


and audio and video feeds. The Oktoberfest 
machine also uses Surrogate’s own SurroRTG 
low-latency video codec to enable a smooth 
gaming experience. 

Most of the code to interact with the arcade 
machine and for the game logic is Python-based. 
Although the SurroRTG software is not currently 
ayenaule one, pee oat eas oo ” screen can be seen, then attach them via USB 
launch it as a free download in the coming weeks to Raspberry Pi 4. Either connect the machine's audio 
and reassure us there are exciting plans afoot to to a USB audio card or use the webcam microphone. 
entice makers with an eye on creating their own Plug in an Ethernet cable and power source. 
geaming setup. Hl 






Position webcams so the pinball machine 
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Joe 
Kutner 


Joe Kutner (aka 
Codefinger) is a 
software architect 
at Salesforce.com, 
where he works 
primarily with 

Java and other 
open-source 
technologies. He's 
published several 
books about 
programming with 
Ruby and Java. He 
enjoys amateur 
astronomy, mostly 
observationally, but 
he also dabbles in 
astrophotography. 





Autoguider 


The awe-inspiring wonders of the night sky encouraged a keen stargazer to 
find a better way to capture their beauty. Rosie Hattersley gets inspired 


reating stunning photographs of the 

night sky requires planning, patience, 

and reliable star-tracking equipment. A 
desire to travel a little lighter led keen amateur 
astronomer Joe Kutner to embark on his first 
Raspberry Pi project. 

Joe says there’s nothing worse than taking hours 
of astrophotography images only to find out your 
telescope was drifting, causing the stars to look 
more like lines than points. To protect against this 
kind of misalignment, he needed an autoguider: 

a computer and camera that track a star in the 
telescope’s field of view to ensure that it stays in 
the same position throughout the session. 

“The main goal of my project was to get rid of 
the laptop,” Joe tells us. “I needed to control my 
telescope in the field. I spend enough time in front 
of a computer at work, and the laptop took the fun 
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out of observing. It served an important function, 
though: controlling both my camera and my 
mount. Without it 1 would only be able to take very 
short exposures of the moon and planets.” 

Joe considered using an iPad or a Microsoft 
Surface instead, but both were far too expensive. 
He wanted to keep the build cost below S100, and 
neither worked well with his chosen software. 

Instead Joe picked up a Raspberry Pi, a case, and 
a touchscreen for less than S100, and added a red 
plastic cover so he was still able to use the setup 
in night-vision mode. These work alongside the 
various bits of astronomy kit Joe uses regularly on 
his stargazing missions. 


Under open skies 
Joe made extensive use of general purpose open- 
source software such as Raspbian Stretch and Git, 
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Raspberry Pi 
The Horsehead Nebula and Flame Nebula, , records over 
photographed from Joe's Alabama driveway with th 
the help of his Raspberry Pi-controlled autoguider : vee nes 


while Joe sleeps in 


Raspberry Pi ina case his tent 
with a red plastic overlay 
so it can be used at night 
Joe recommends 


Lacerta MGEN II 
(magpi.cc/3XGdSW) 
if you don't want to 
build your own 


Many of his 
astronomy photos 
are taken from 
Huntsville, Alabama 


He's using 
Raspberry Pi to 
attempt to image 
an exoplanet transit 


He also blogs about 
coders’ fitness 

and nutrition at 
healthyprog.com 
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A Lagoon Nebula (Messier 8), a giant interstellar 
cloud located in the constellation of Sagittarius 


plus astronomy-specific open-source tools Libnova 
(magpi.cc/libnova), INDI (indilib.org), and PHD2 
(openphdguiding.org) telescope guiding software. 

He wrote scripts to automate the software so he 
could just use the touchscreen, without a mouse 
or keyboard. But for the most part, things worked 
without customisation. 


M | can roll it onto my 
driveway and start imaging 
In just gd few minutes @ 


“Every step in the process had its challenges,” 
Joe recalls. “I would install one piece of software 
and then find out it wasn’t compatible with some 
version of another piece of software I needed. 
When I finally got everything running, it wouldn’t 
talk to my telescope until I installed yet another 
version of the software. There were dozens of 
these little paper-cuts, but in the end it was worth 
working through them.” 

Joe also says the hardware he chose worked 
perfectly from day one. Any tweaks he made were 
“mostly minor issues like figuring out how to install 
the correct version of a particular camera driver”. 

His Raspberry Pi now has an on-board 

A Whirlpool Galaxy (Messier 51) taken at the Texas Star Party 2019 in Fort Davis autoguiding system for his astrophotography rig. 
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Because Raspberry Pi attaches to the base of the 
mount, it’s easily accessible. Unlike using a laptop, 
there’s no need for an extra table or complicated 
wiring. Joe says the setup is perfect for his needs: 
“T can roll my telescope onto my driveway and start 
imaging in just a few minutes.” 


International expansion 

Now that Joe has successfully built a fairly portable 
astrophotography rig, he sees its potential for 
explorations further afield. He’s keen to try out his 
autoguider with other types of astrophotography 
kit such as the ultra-compact Sky-Watcher Star 
Adventurer series of mounts. “When combined 
with my Raspberry Pi,” he says, “I could take the 
whole rig on an airplane as carry-on. That would 
give me access to some very dark skies.” 


MGEN . 


2INPOINE stars every time 
IINDOINE sta V CUT 





A The lightweight nature of 
Joe's astrophotography 
setup makes it easy to 
move around 


0 Lacerta MGEN llis a 
good alternative if you 
don't want to build your 
own autoguider 





so 
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Build an autoguider 


2 sm + t : a 
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01 Start with a fresh installation of Raspbian 

and download the package for libnova 0.14. 
You can find the install instructions at Joe's GitHub 
page (magpi.cc/Xn4JCE). 
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02 Use the GitHub instructions to build INDI, 

the software to connect Raspberry Pi to your 
digital camera and mount. Install the Atik camera 
driver if needed. 


03 Install and build PHD2 autoguiding software, 
then start the INDI server so it looks for 
the camera and mount. Save the profile for 
future reference. 
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Hot Spotter 


An autonomous drone that can detect and report smouldering fires. Phil King seeks it out 





Jason 
McDonald 


Jason has a degree 
in Applied Physics 
and numerous 
‘nanodegrees' for 
machine learning 
and Al. He is 
currently enrolled 
at the University 

of Montana in the 
welding technology 
program. 


magpi.cc/ 
hotspotter 





Alert! 


Drone use is regulated 
in some territories 
(including the UK 

and USA). 


magpi.cc/CAAdrones 
magpi.cc/ FAAdrones 


> Preparing for take-off, 
the Hot Spotter drone 
is pictured in front of 
a charcoal fire used 
for testing purposes 


hile commercial operations use fleets 
of expensive drones to track the 
spread of wildfires, it’s possible for 
a previously extinguished fire to relight. It’s in 
the detection of these smouldering patches where 
a low-cost drone such as Jason McDonald’s Hot 
Spotter could come in useful. 

“T wanted to create something practical with the 
[NXP HoverGames drone] kit that filled a niche 
not already being targeted by the commercial 
drone industry and/or lower the cost of a current 
application,” he reveals. 

Made from off-the-shelf hardware, including 
a Raspberry Pi 3A+, the Hot Spotter can survey 
an area to create a heat map. “As the drone flies 
over an area, it records average temperatures of 
spots on the ground,” explains Jason. “The size of 
the spot depends on how high the drone is flying, 
in the same way the spot size from a flashlight 
depends on how far away it is from a surface.” 

The software creates an imaginary grid of points, 
spaced about one metre apart, to be used for the 
heat map. When the drone takes a temperature 
reading of a spot, it’s recorded for all the points 
contained within it. Then, when the heat map is 
generated, all the readings for a given point are 
averaged together. “This method helps to localise 
heat sources and distinguish between large warm 
regions versus hot spots.” 
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A Anexample heat map generated by the drone's Raspberry Pi 
as it flew a cross-hatch pattern above the survey area 





As the drone flies a cross-hatch pattern to survey 
the area, its on-board GPS is used to determine 
its precise position while a lidar module measures 
the distance to the ground. This results in more 
accurate heat mapping than when estimating the 
height, as well as opening up the possibility of 
terrain following and obstacle avoidance. 


Altitude testing 

“For my tests, the drone flew about 20 metres 
above the ground,” says Jason. “I would like to 

test at other altitudes. Since the size of the spot 
being measured increases with altitude, the drone 
can cover more area from higher altitudes at the 
expense of heat map fidelity. Ideally I would like to 
create a quick map from a high altitude followed by 
a higher fidelity map at a lower altitude for regions 
that look like potential hot spots.” 

The on-board Raspberry Pi 3A+ communicates 
with the drone’s flight controller (using the 
MAVLink protocol) to receive information such 
its GPS position and orientation. “Raspberry 
Pi handles all of the calculations necessary to 
generate a heat map from sensor data recorded 
by the drone and from sensors attached directly 
to the GPIO using an I?C hub,” says Jason. 
“Raspberry Pi can also command any autonomous 


Connected to a Raspberry Pi 
3At, the thermal sensor on 
ida\omeolce)alowomelale(=le-j(e(-me(siK=1ed ks} 
dal=Melcolelaremnciaalel-ig-laela=) 


LiPo battery power is wired 
via the drone'’s power 
fol f-jaglolUld(elau eler-lceit-la(em- MO) =) 10 


functions such as setting a waypoint and 
returning to its launch point.” 

It sends the data in real-time — using a wireless 
serial connection via a500mW transmitter — to 
a ground station laptop via another Raspberry Pi 
used as a wireless hotspot for a laptop. 


Crash landing 

It took Jason three months to build and program 
the Hot Spotter. However, after numerous 
successful test flights, disaster struck when the 


drone crash-landed due to a malfunctioning rotor. 


“Tt was a bummer to say the least,” he says. “I 
have rebuilt the drone. Better than it was before. 
Better... stronger... faster.” 


HOT SPOTTER | 


ject Showcase 


A lidar sensor is used to 
measure the distance to the 
fo] colulale Mol=\Ko\\ mie) ml lalel c=r=Isi-70 
accuracy of the heat map 
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™ As the drone flies over an 
greg, it records average 
temperatures of spots on 
the ground @ 


While he thinks the drone’s practicality is 
solid from a cost standpoint, its practicality ‘in 
the wild’ remains to be seen. “I would like to do 
further testing that includes real-world scenarios. 
There is a fire science laboratory (firelab.org) near 
me and if they find it useful, the project might 
have a future there.” H 
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> The project won 


a special award 
in a HoverGames 
contest 


It's powered 
by a5200mAh 
LiPo battery 


The drone can 
hover for a solid 
20 minutes 


In a ten-minute 
flight, it can 
survey a 1600 m? 
area twice 


>» The code is on 


GitHub: magpi.cc/ 
hotspottergit 


The Official Raspberry Pi Handbook 2021 | 47 








48 


Project Showcase 


Observation System 


What computer do you use when you want to have a solar-powered, gutonomous boat 
that measures water guality? Rob Zwetsloot discovers that the answer is Raspberry Pi 





Murray 
Lowery- 
Simpson 


Although coming 
from an engineering 
background, 

Murray has been 
developing 
software for a little 
over 20 years. 


AMOS will be useful 
to researchers, anda 
good base 

for hobbyists 


here are many basic rules when it comes to 

electronics. One of them is that water and 

electronics don’t mix, even if your average 
smartphone is able to take a brief dunk in the sink 
these days. So when someone comes to us talking 
about a waterborne project, we listen — and that’s 
exactly what happened when Murray Lowery-Simpson 
emailed us about his solar-powered boat. 

“My project is named AMOS (Aquatic Mini 
Observation System),” Murray tells us. “It is a solar- 
powered, autonomous airboat for measuring water 
quality over large, distributed areas.” 

Murray has worked on a couple of prototypes for 
the boat. The first one was made out of a kayak beer 
cooler (a small kayak that acts as a beer cooler) and 
had propellers that would end up getting gunked up. 
He also tested distance measuring with a Raspberry Pi 
Compute Module’s stereo vision before settling ona 
lidar module and a Raspberry Pi 3B+. 
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“During this past winter, I built a second 
prototype, this time using a longer surfboard- 
type design constructed from glued-together 
insulation foam that was given a coat of fibreglass 
to give it some added strength and stiffness,” 
Murray explains. “Instead of the water propellers, 
a Single 10-inch drone propeller and motor were 
used and connected to a small waterproof servo 
motor at the stern end of the boat. This design was 
lighter (about 13 kg) and longer, and although the 
air propeller only produced about a tenth of the 
thrust provided by the dual water propellers, the 
improved draft and hydrodynamic shape made it 
slightly faster in the water.” 

A Raspberry Pi controls the speed and angle of 
the air propeller, takes sensor readings from the 
water, interacts with the lidar module, and has 
several other functions so that it knows its speed 
and heading. 








TTY) Deere ee 8 
Sa Te 
The boat is fully 

automated and, on 

a sunny day, fully 

self-sufficient 


> Murray got into 
robotics in late 2017 


He was inspired by 
local news about 
PANG Wo fl at-lale Mer-laal=1e-) pollution on 


reY(oMlamar\alellaceyal public beaches 


AMOS tests PH, 
salinity, dissolved 
oxygen, turbidity, 


: and more 
PNSSU1 | Koo) meox=) a Xe) goes a =109.@h dal =) 


water's chemistry —- soon it 
771 i ==) a Ke) al f= (oi k=l ara! 


Pictures from the 
Camera Module 
are mostly used to 
locate a lost AMOS 


AMOS can 

be controlled 
by iOS and 
Android devices 


€ The old version was 
a bit slower and 
stubbier, and the fans 
would get weeds 
stuck in them 
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Project Showcase 





ES cal ge canis e uie “?’m hoping that AMOS will be used for water 
an Idea Oo e SIZE Oo . : . . 
the boat testing by environmental services companies, and 


industrial customers such as mine operators that 
may be required by law to confirm that pollution 
limits in bodies of water surrounding their 
operations are not exceeded,” Murray reveals. “I’m 
hoping also to be able to offer it at an attractive 


Approximately 150 km of testing has been 
completed on the second AMOS prototype 


price point, with modular components so that 
researchers or robotic boat enthusiasts could also 
use it, or some subset of it, in their own projects.” 


Major tests 
The prototypes aren’t just proofs of concept, 
either: they’re fully functioning test beds, as 
Murray explains: “Approximately 150 km of testing 
has been completed on the second AMOS prototype 
in 2019. It can work well in shallow water (as little 
as 2cm depth) and can travel through regions of 
water with lots of grass or other vegetation without 
any worries about getting stuck. Its airboat design 
works best under conditions of low wind (less than 
20 km/h) and it can travel at a top speed of about 
2.7 knots (5km/h). Provided the sun is shining on 
a clear day and higher than about 40 degrees in the 
sky, AMOS can run at top speed without depleting 
the charge of its battery.” 

Murray plans for AMOS to be on sale in the 
summer, so you don’t have too long to wait. 
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We think the AMOS 
looks quite majestic 
as it pootles about 


AMOS also works 

in cold weather, 
although a lack of sun 
means it can't operate 
for long 


The surfboard body 
makes It light, and its 
length allows fora 
large solar panel 


Project Showcase 


Testing the waters 





A boat needs to be launched. You can control 

the destination using a smartphone; there are 
apps for Android and iOS that you can find on the 
GitHub page: magpi.cc/amosGH. 





Using a combination of GPS, lidar, and 

cameras, the boat navigates its way around 
waterways and rivers. This allows it to obtain a 
big sample from any given area, and see how it 
changes throughout. 





Ona sunny day, it can happily take readings all 

day without too much interference. On a cloudy 
day, it may only operate for up to an hour. Although a 
bigger battery might solve this, it will be heavier. 
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ES) Project Showcase | AiRDRUM 


Airdrum 


This drum set can be played with a hover of your hands 
Gnd gives visual feedback too, ds David Crookes learns 


e’re always going to beat the drum for 

projects that seek to improve the lives 

of people with severe disabilities. To 
that end, we fell in love with the Airdrum, which 
was created to allow anyone — in particular those 
with a mental or physical condition — to playa 
traditional instrument. 

Designed by two Dutch electrical engineering 
students, Alessandro Verdiesen and Luuk van 
Kuijk, the project came to life during their first 
year at university. “We aimed to develop a musical 
instrument that could be used to generate music 
by moving,” explains Alessandro, who has recently 
been working on a fully modular version 2.0. 

After speaking with therapists and health care 
institutions, the pair decided to make a drum that 
could be played by moving objects above a set of 





Alessandro 
Verdiesen and 
Luuk van Kuijk 





; ; A Custom-made Airdrum detecting modules fit snugly into their 
panels and they put a Raspberry Pi at its heart. 3D-printed cases and can be arranged in a full circle if you have 


Alessandro is an 


electronics engineer “The basic functionality of the Airdrum is to detect ener traee 

with a passion for the distance of an object above each connected instrument to have a broader appeal and be 

ae cues panel and play a sound,” says Alessandro. “These suitable for everybody, including professional 

(ae is studying panels contain IR distance sensors and coloured musicians, so it had to sound as good as it played. 

for his master’s LEDs for visual feedback.” “We needed it to be as versatile as it can be and 

ie ae allow people to choose custom sounds, colours, 

| Sorting the bass-ics and lights while being a standalone instrument and 

magpi.ce/airdrum From the outset, Alessandro and Luuk needed their a multi-purpose input/output device,” Alessandro 
project to be accessible, affordable, adjustable reveals. To make it easy to place the modules 
and, in the latest iteration, modular, with each together, they used magnetic connections between 
drummable section containing an Arduino Mini, the panels. This allowed them to be placed together 
an IR sensor, and LEDs. They also wanted the in various configurations, with a minimum of two 

per Airdrum. 


With a structured plan that divided milestones 
into electrical, mechanical, and software 
components, the pair used 3D printing for the 
enclosure, which enabled rapid prototyping for 
quick interactions. They used speaker panels to 
bookend the modules for auditive feedback. 


Panel beating 

Each of the panels includes a buck converter 

so that the current through the connectors can 
be drawn to a minimum. The master module 

into the creation of 


ee ere i ms panel contains a Raspberry Pi 3 running custom- 
past few years aa = . made programs written in C and Python, as well 


> A lot of meticulous 
planning has gone 
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AIRDRUM | Project Showcae 


This master module panel packs a 'S¥eXod a o)al-Me) m4 ai-o\omlal-1ceral=laleicrele) t=) 
c1=) alsio) aim = DAWN co [Ul lavom\yilalmrsl are ole (os. laatete|U|\=vm ats lomo elec\\(4=) a lam dalsmc] D) 


converter, as well as a Raspberry casing for the Arduino Mini, sensor, 
Pi which generates the sound and : lolU Cer q@ete) alYi=a Ke) @mr-lale Mm os- 14-1 aVamr-lale| 
K=Yato [oid al=m 0) ce) (-1ea mm =4U(-1 Kole) AVA Al ap Nal= Vm e-mexe)alarcreak=reM//i4ameltal-1 65 

up Grell mm-lalem Ops) sMer-ley-le) lila (or) UisTave manatee latcies 


Vd atolame arclalemelmeltal-16 
fo) 0) (=You ml Io eys tsi =10 MO).=) 6 
the top of a module, it 
fe] alasmel ek-Vale me) f=\Vorr-| 
Yolul ale Mes) el=1-1.¢-1 goers lal ol=) 
fo) FaYex-1om xem val-mK-y aml ale. 
ae]al mel iat-maaveye (el l=s— 





panels, although the 
sound can be outputted 
via the Raspberry Pi 

to a different sound 
system too 


< ese speaker MOAULES 
Mm |t also has a 12C bus to | 7 can bookend the sensor 


act as d data transfer 
master unit @ 


as the free open-source software synthesiser 
FluidSynth. It connects to the other panels 
through 12C, constantly polling the panels for 





their measurements and for the configuration of ‘a scala psop’e 
= can play without 
their colour. X holding it 

“Tf an object has been detected, the Raspberry 
Pi generates a sound and outputs it on the AUX > Anew modular 
audio jack,” says Alessandro. “This output is then design makes 
used by the mono D-class amplifiers in the speaker it versatile 
panels to make the tones audible.” 

The pair chose a Raspberry Pi because of its to fit inside of the casing. The Raspberry Pi enables > It can play MIDI files 
versatility and technical prowess. “The Airdrum easy implementation of future upgrades, too.” via a Raspberry PI 
needed something powerful enough to run Indeed, the pair want to explore the MIDI . 
software to generate audio through MIDI using possibilities and connect the Airdrum with a ‘ inte aie 
the input from the panels and the Raspberry Pi smartphone or tablet. An app is being planned, ‘ itt m 
is a great universal and low-cost development as is a built-in synthesiser. “The people we 
board with integrated DAC for audio,” explains have shown the Airdrum to have been very > Abasic two-module 
Alessandro. “It also has aI2C bus to act as a data enthusiastic,” Alessandro says. “That has been Airdrum would cost 
transfer master unit and they’re compact enough very motivating.” H] about £120 
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ES) Project Showcase | CHEESEBORG 





Cheeseborg 


In wintertime, what could be more comforting than a grilled cheese sandwich? 
Cheeseborg uses Raspberry Pi to serve them up, ds Rosie Hattersley smacks her lips 








Taylor 
Tabb 


Taylor studied 
mechanical 
engineering at 
Carnegie Mellon 
University, exploring 
how people interact 
with hardware, and 
thinks Raspberry Pi 
is the ideal platform 
for this. He now 
works for creative 
agency DeepLocal, 
making ‘wild and 
whimsical’ robots. 


tabb.me 


Warning! 
Hot mess! 


Gooey butter is messy 
stuff. Be prepared for 
your kitchen, as well 

as your grilled cheese 

sandwich, to be buttered 
all over! 





aking a splash with your final-year 
university project can be the ideal way to 
gain the attention of potential employers 
and land yourself your dream job. Appealing to your 
lecturers’ and classmates’ stomachs is also a pretty 
effective way of getting them onside. Hearing from 
Taylor Tabb about the robot project he and friends 
Mitchell Riek and Evan Hill cooked up for their 
mechanical engineering degree, it’s little surprise 

to learn that having graduated in the summer of 
2019, he’s already embarked on a fantastic-sounding 
Raspberry Pi-focused career. 

“Cheeseborg was born out of our need to concept, 
design, and build a final prototype of a project in our 
senior engineering design class,” says Taylor. “As 
hungry college students awake at hours that it’s often 
hard to find food, we knew this was our calling — not 
just for us, but for grilled cheese eaters everywhere.” 

Cheeseborg is a dedicated, hands-free grilled 
cheese making robot that will satisfy cheese cravings 
at all hours. The Google Assistant SDK and AIY Voice 
Kit provide voice activation. Both “work fantastically 
with Raspberry Pi 3 Model B+,” says Taylor. Their 





M 
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Cheeseborg requires you 
to say please when you 
ask for a grilled cheese! 








AC 


HEESEBSRG 


sENUINE MELT-O-MATIC 


(@1 al ={=\-1-] ole] ge B-w- (ol ates 
loXere Wao al(efe(-laMlair- Wl t-\1>) ge 
=) Kol al=Te MV /Lelele m=) aves Koy-el a=) 


PNAVE=\oib le laa e)(el come!) 
the slice of toast to be 
wolelak=1¢-10 ll ol-1e)q-m Key-t-18] ale] 


People usually love Cheeseborg's 
la\Y] oL=) ee aal=xe ate} al(ere|@ aalel dle) al-m er-lig-ve| 
with the whimsy of grilled cheese 





Raspbian and Raspberry Pi allowed 
(Ot al=T=3-1-] ole) ge BoM a at=1.<-1 6-9 Ke =>.4 0) Ke) a= 
dozens of versions of its interface 





outils FACTS 


His first Raspberry 
Pi project was a 
‘not great’ radio 
telescope 





Vv 


Taylor now works 
with Raspberry Pi 
almost daily 


His business card 
says he's ‘sweeter 
than Raspberry Pi! 


Vv 


Vv 


Taylor thinks 
there's a whole 
world of culinary 
robots to come 


Vv 


He recently made 
a not-so-edible 
bubble maker: 
magpi.cc/ 
loTfBubbleMaker 





a The Cheeseborg even 
features a mini chute for 
delivering the sandwich 


4 We do love a grilled cheese 
sandwich and this one looks 
pretty tasty 
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WS) Project Showcase | CHEESEBORG 


Cheeseborg beg 

to take shape in the 
Carnegie Mellon 
University makerspace 





_ the acrylic parts were designed and laser-cut 
mA dedicated, hands-free grilled cheese ey ee aa end eee ase 
ma Ki ng robot th gt Wi | | Satisfy ch ease the project cost just $200 to build, and took 


approximately eight weeks to complete. 


cravings at all hours @ 


Taste test 
customised build of Google Assistant, sourced from The team undertook three weeks of customer 
the AIY Kit and Google Cloud SDK, allowed them research to identify grilled cheese preferences. 
to add some personality: you can ask about the “There was a lot of going back and forth between 
weather while awaiting your sandwich. our build, CAD software, and laser cutter, adjusting 
Raspberry Pi also triggers its assembly, while parts as we learned more about the mechanics of 
motor control circuits and motion are operated by bread and cheese,” recalls Taylor. They spent days 
Arduino Mega. Taylor reveals, “We wrote our own just tuning the grilling time to get the gooeyness 
code, but also used open-source Arduino libraries,” and crispiness just right, while experiments in 
dictating timings and the motions for each step. applying the butter resulted in a thoroughly dairy- 
Carnegie Mellon’s Department of Mechanical spattered makerspace. 
Engineering’s makerspace provided hardware Eventually, they went with a spray ‘butter’. 
commonly used in 3D printer kits, such as stepper “We aimed at the cooking plates and activated 
motors and linear motion carriages. However, just before the bread was moved to be cooked, 
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A Cheeseborg’s makers 
earned even more goodwill 
from their classmates when 
they brought it along to 
their design expo 


4 Taylor, Mitchell, and Evan at 
5am, just after Cheeseborg 
was finally finished 





thus buttering both sides [not to say the rest of 
Cheeseborg]. In the end, we found if we just spray 
the grill plates every five [sandwiches] or so, it still 
is enough to make a crispy, gooey grilled cheese! 

“As with all good projects, we had no idea if it 
was going to work until 4am the morning before it 
was due, when Cheeseborg popped out its first fully 
hands-free grilled cheese sandwich.” 


Making your own grilled cheese robot 
Interest levels online have been such that Taylor 
and his colleagues may consider offering a kit 
version. While he cautions that there’s a huge 
amount of fine-tuning involved, he says, “If 
anyone out there is building a grilled cheese robot, 
we’re more than happy to offer any insights.” 
Contact him at tabb.me/grilledcheese. {I 








CHEESEBORG | Project Showcae 


Making your own 
grilled cheese robot 


01 This is the ideal project with which to use 

Google Assistant in Google's Raspberry Pi 
AlY Voice kit, and the Google Cloud SDK for voice 
activation. Experiment with phrases to initiate the 
snack-assembly process. 


02 Raspberry Pi now hands over to Arduino. 

Use Arduino Mega to control the robot that 
assembles the grilled cheese sandwich once 
Raspberry Pi instructs it. Open-source Arduino 
libraries are invaluable here. 


— 


ss 
| 
4 9 i 


a} Use tongs or suction to pick up slices of bread 

and add a chute for the snack’s delivery. 
However, positioning bread to be buttered and 
adding cheese takes patience. 
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Project Showcase | BIT TIME - ROTARY DIAL PHONE PROJECT 





Bit Time — Rotary 
Dial Phone Project 


A unigue project in Essex explores how all ages engage with the tools that enable 
us to communicate, including using two upcycled retro phones, Nicola King dials In 








Dave Norton 
and Laura 
Trevail 


Dave is a Digital 
Artist and Drama 
Practitioner, and 
his work ranges 
from large- 

scale interactive 
installations to live 
theatre performed 
in a virtual world. 
Laura Is an Artist 
and Context 
Strategist with an 
outdoor theatre and 


live-art background. 


magpi.cc/bittime 


a wider initiative called Bit Time - a 

project that has been running in Basildon 
over recent months. Lead artist Laura Trevail 
explains, “Bit Time is an intergenerational project, 
combining the skills and knowledge of the very 
young with those of our elders. As artists and 
facilitators, we’ve been bringing together these 
ideas and possibilities into playable works that in 
themselves keep that momentum going. These 
are projects about communication technology, 
but they are also communication technologies in 
themselves. By interacting with the art, you are 
interacting with each other.” 


T he Rotary Dial Phone project is part of 


Cold calling 
So, the retro phones... where do they fit into this 
story? Phone project artist Dave Norton says, “The 





os Bi dlele(=1c=1eM o)var-| nt 4 
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walks past it 


The answer phone plays a 
igslale(o)aa las) ele)alsi-m g-rere) ce (cre. 
ice)aamdar=me [U(=1-)4(e)am o)ale)at= 
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inspiration for the question/answer phones came 
from a desire to build a device that lets you share a 
message with someone you’!] never meet. A digital 
time capsule of anonymous thoughts, advice, 
stories, and memories that could be listened to 

by anyone. You have no idea who might hear your 
message and how it could affect them.” 

He explains how the system works: “You walk 
past a phone and it starts ringing, you pick it up 
and the operator asks you to answer a question, 
e.g. ‘what was your first phone?’, ‘what will a 
phone of the future look likee’ A ‘recording’ light 
comes on and you leave your message and hang 
up. Later on, you see another phone that also rings 
as you walk past; you pick it up and it plays backa 
random message left by someone else.” 

A motion detector identifies when someone 
walks past, while a push-button detects when the 


| J ia = 
J 
? 


aMal=mele(=s-14(e)ame)areyal=) 

fo) Fe\ acme ce lavete)aame [e(=r-ia loyal 
1Kom//alol=\"(-) a 0) (el come ommal=) 
handset and records 
their response 
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Due to power constraints; the 
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Kol ok- me |[srexe) alal-reik=1ome(Ulalalemoxelelaule) 


receiver is lifted. The phone’s mic and speaker 
are hooked up to a Raspberry Pi, which chooses 
a random audio file question to play. “The mic 
starts recording the user’s message for 15 seconds, 
or until they hang up, then the whole process 
restarts. The answer phone works in a similar way, 
but only chooses random audio files to play back.” 
Since the installation needed to work in any 
kind of location, it couldn’t rely on WiFi to transfer 
audio files between the phones, particularly as the 
audio files needed to be checked manually before 
they could be shared with the public. “I ended up 
having to code a ‘syncing’ mode, which is activated 
when a USB drive is inserted into Raspberry Pi, 
which automatically transfers all the audio files to 
the drive,” reveals Dave. 


™ Some people just hang 
Up straight away, some 
people audibly freak out @ 


You talkin’ to me? 

The Bit Time project, including the rotary dial 
phones, ultimately became an exhibition which 
toured Basildon in the summer of 2019. Dave says, 
“There’s something really unburdening about 
being anonymous, and something really pleasing 
about being given an open platform to speak your 


DIAL PHONE PROUECT | ? 


ag 


eee fr? 








A Dave says it was easy to snip the wires from each phone's speaker, 


mic, and hang-up button and connect them to Raspberry Pi 


mind. I loved the idea that the installation starts as 
a blank slate and, as it travels to different events 
and locations, it collects a mixture of stories and 
thoughts and shares them with anyone who cares to 
listen, something akin to a travelling storyteller.” 

He says the phones elicited a variety of 
reactions. “Some people just hang up straight 
away, some people audibly freak out that they’ re 
actually being recorded, some yell bizarre phrases, 
but most people genuinely answer the question. 
No two answers have been similar and it makes for 
some really interesting listening... We’ve ended up 
with hundreds of varied audio responses — it would 
be lovely to build some sort of audio installation 
using all the clips.” Hl 
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The phones project 
took around three 
weeks to complete 


Basildon Library 
Creator Space 
provided a location 
to construct the Bit 
Time artwork 


A 5V solenoid is 
used to ring each 
phone's bell 


Dave programmed 
each Raspberry Pi 
using Python 


He suggests the 
phones could be 
used in the foyer 
of a venue after 
an event, to glean 
honest views 
from attendees 
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ES) Project Showcase | NEOPIXEL LED MIRROR 


NeoPixel LED Mirror 


Your face in lights thanks to 576 LEDs. Rob Zwetsloot puts on his 
best hat and takes a look at this ‘mirror’, and himself 





Alex 
Schepelmann 


A DIY YouTuber 
who dabbles 

in Raspberry 

Pi, robotics, 
electronics, and 
3D printing. During 
the day, he’s an 
engineer working 
On robotics and 
computational 
modelling. 


magpi.cc/ 
supermake 


Vv ARaspberry Pi handles 


it all, although another 
computer is on hand 
for project info 


agic mirrors seem to now be a rite of 
passage for many makers and Raspberry 
Pi aficionados. It’s a fun project, but we 
think this LED mirror from Alex Schepelmann is a 
little more striking. 

“The project uses a Raspberry Pi 3B+, a Raspberry 
Pi Camera [Module], Python, 3D printing, and 576 
NeoPixel LEDs to create an interactive art piece 
that shows you your reflection in ‘low resolution’ 
by lighting up a grid of LEDs,” says Alex. 

In essence, it’s taking your picture using a 
Raspberry Pi Camera Module, converting it to 
a low-resolution picture, and then setting the 
LEDs to the same colour as the individual pixels 
in the resulting image. Magic? Yes. Practical? No. 
Fun? Absolutely. 


M 





Mirror art 

Where did such an idea come from, though? “I was 
inspired by the various ‘analogue mirrors’ made 
by Daniel Rozin,” Alex reveals. “The Children’s 


‘4 
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7 


| 
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A Alex eventually got a laser cutter to help speed up 
production - like for these mounting grids 





Museum of Pittsburgh, where I built an exhibit fora 
Systems Engineer class that I took during graduate 
school, had one of Mr Rozin’s mirrors on display. 
The mirror at the Children’s Museum used blocks of 
wood and servo motors to display images of people 
who were Standing in front of it in low resolution. 
Ever since then, I’ve been following Daniel’s work, 
and wanted to build one of his mirrors myself. I 


™ Shows you your reflection 
In low resolution by lighting 
Up a grid of LEDs 


thought that such a project would be perfect for 
my YouTube channel (magpi.cc/supermake), 
because it would allow me to put my own twist 
on the concept while simultaneously teaching 
people about programming, 3D printing, laser 
cutting, and more!” 

The build itself has an impressive list of 
components. Alex created a custom prototype 


NEOPIXEL LED MIRROR | Project Showcae 
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are low-resolution, 

but you can still make 
* out what they're of! 





PNaWe)atomlamiceyal me) 
MYA lemel=melisje)k-\i-r6. 
Ta 4al=maallanela 


The Official Raspberry Pi Handbook 2021 | 61 


tI att 


owe af uh Fe = = 5 F 
‘s 4 hee ei “ ae 
ry: - ~ + vd] ’ * im 
3 = 4 ui = r = "ee a a » = = ‘ 
c 7 " a a r- é 
a a tS BEE. of : es. - “a ; es “4 Pre “<= $ ai 
ebssy Ge a7 od ; Porta tet bode oe Cy 
Fa — _ Ge re hw = 7 
aren? ‘¢ tt I ge ede WO ee a ate 
rss opting - - _— ~.., ha Pa? ait ee a 





Project Showcase 





Camera settings are locked as the code 
starts, before capturing the image and 
selecting a small region of 24x24 pixels. 





People were taking PCB, 3D-printed and laser-cut several parts, and 
selfies of themselves ; : 
with their ‘reflection’ connected 24 strips of 24 LEDs to make the magic 


576 number. A Raspberry Pi was used to power it 

p a due to its size, ability to run Python and address 
pe 2-8 8 F all the LEDs, along with the Raspberry Pi Camera 
Module which makes it all possible. 


(forse ee20) 





This image is then converted to greyscale, 
after which the code extracts one of the On display 


image's colour planes from the image as an array. With such an unconventional project, you might 


This aiey contains the brightness igetiaeuisty for expect some issues when it was finally unveiled. 
each pixel of the extracted 24x24 region. This square 
However, it went down very well. 


array is then reshaped into a 1x576 vector, and 4 
brightness values are assigned to LEDs. The project made its debut at the 2019 


Cleveland Maker Faire, where it ran for over 
eight hours during the event without a single 
hiccup,” says Alex. “An advantage of being 

able to run everything via Python code is that I 
could adjust camera settings on the fly based on 
lighting conditions in the location where I was at, 
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Brightness values are used to light up each 
pixel, after which the image is cleared and the 
image capture/display process are repeated. In order 
to be able to display images as quickly as possible, 
the Python code is optimised to operate on vectors shige toga cs 
3D-printed out of clear 


and to minimise the number of for loops. PLA and then glued into a 
laser-cut mounting grid 
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NEOPIXEL LED MIRROR | Project Showcae © 
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- > Nearly 600 parts 
A. Diffuser plates are ~ af were 3D-printed 
required on all the LEDs “a 
— a job for a glue gun = or laser-cut for 


the mirror 





™ People were fascinated 
by the mirror and enjoyed 
moving their limbs and 
making faces in front of it 


> Version two may 
use full RGB colour 


> Alex spent nearly 
three years on 
the project 


> The display could 
be used for 
signage and QR 
codes as well 


making sure that the mirror clearly displayed the 
reflections of visitors throughout the day. 

Maker Faire attendees interacted with the 
mirror and stopped by the Super Make Something 
booth to learn more about the YouTube channel, 
Raspberry Pi, and Python programming. “One 
of my favourite observations I made during this 
event is that the mirror captured the interest of an 
audience with a broad age range — people between 
the ages of 5 and 65 were fascinated by the mirror 
and enjoyed moving their limbs and making faces 
in front of it, excited to see what would happen.” 

If you’ve not managed to see the mirror in 
person, all is not lost. Alex has been in discussions 
to add the mirror to the Great Lakes Science 
Center, very hopefully with upgrades. Look out for - ae eee 7 
more info on his YouTube channel. a time-consuming job 


> You can get the 
code and design 
files at magpi.cc/ 
ledmirrorgit 
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ES) Project Showcase | ADVENTUREPI 


AdventureP1 


Zach Levine's portable arcade project lets you choose 
your own AdventureP!, gs David Crookes explains 


brother ended up owning a good number 

of video game consoles, including the 
Game Boy, Virtual Boy, NES, Nintendo 64, and 
Sega Saturn. “But we also frequented the arcade at 
the local bowling alley quite often,” Zach tells us, 
and this love of coin-operated gaming machines 
never left him. 


A s big fans of gaming, Zach Levine and his 








Zach As such, when pondering his next project 

Levine . 

with a Raspberry Pi, he decided to create a 

ee portable gaming device that would be as robust 

programmer, as an arcade machine. “A lot of people my age 

—— tinkerer, move around a lot or live in apartments and no 

OulUber, = > The Console Edition is essentially a Raspberry Pi with 
and howchoo ee really wants to lug around a tree standing RetroPie installed connected to a display in a case with 
founder living in cabinet, so I looked to create a device that would foam inserts for controllers and accessories 
Tampa, Florida. feature full arcade controls.” 

magpi.cc/ In fact, Zach ended up creating two different RetroPie OS (retropie.org.uk) which allows games 
adventurepi versions of his project. As well as an Arcade Edition originally made for older systems to be enjoyed 


that features a removable panel containing arcade with minimal fuss via emulation. 
buttons and a removable joystick, he produced a 
Console Edition that uses a foam block insert with Hardcore gaming 


cutouts for controllers and accessories. Since RetroPie does not yet work on a Raspberry 
“My primary goal was to make the project as Pi 4, Zach had to use the 3B+ model instead. 

accessible as possible and introduce more people Planning proved to be the trickiest part of the 

to Raspberry Pi, hobby electronics, and retro setup, but he knew he needed a display that could 

gaming,” he says, opting early on to use the run on either 12V or 5V, and a single power supply 


M No one really wants 
to lug aground a free- 
Standing cabinet 


that would output enough amperage to run the 
screen and Raspberry Pi simultaneously for hours. 
“From there, it was a matter of finding a sturdy 
case that had a removable panel for the Arcade 
Edition and a foam insert for the Console Edition,” 
he says. A Nanuk 910 waterproof hard case worked 
well, requiring only a little bit of shaving to the 
inside with a box cutter so that the screen would fit 
nicely in the lid, while allowing room for the wires. 


> Toavoidthe 
controller smashing 
into the screen when 
the case Is closed, 
the joystick unscrews 
for easy storing 
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with a detachable shaft joystick made 
by arcade parts maker Sanwa Denshi 


“T found some slim 90 degree cables normally 
used on drones, because there wasn’t the space for 
normal micro USB and HDMI cables,” he says. 


Joystick joy 

For the Arcade Edition, Zach had to essentially 
build a USB controller. “I made use of illuminated 
buttons and a joystick connected to a small PCB that 
turned the setup into a USB device,” he explains. 

He took inspiration from Pimoroni’s Picade cabinet. 
“The controls use the same layout because | figured 
they’d worked things out already.” 

Even so, Zach encountered a problem that 
almost killed the project before it started: how to 
add a joystick within a closable case. “I messed 
around with a few hinging mechanisms and 
then found a company that makes a removable 
joystick,” he says of the fortunate solution. 

As for the Console Edition, that has been a case 
of cutting the foam to house controllers, chargers, 





a Malo wsvelg=\-laMmaceaamelelalcelelare (qa 
runs on either 5V or 12V and fits 
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wires, and other gaming peripherals that can 
connect to the Raspberry Pi, but the fun isn’t 
stopping there. Zach believes AdventurePi will 
eventually be developed as a much smaller 
version using a custom power supply. “I’d also 
like to add a power button that automatically 
shuts [Raspberry] Pi down when the case is 
closed,” he says. 





A cased Raspberry 
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> The project cost 


There are two 
versions: Arcade 
and Console 
Editions 


Vv 


Vv 


It displays toa 
13.3-inch screen 


It uses RetroPie 
for emulation 


Vv 


Vv 


Strong nylon 
fasteners secure 
the components 


Slim micro USB 
and HDMI FPV 








about $250, overall 


cables were needed 
because of the small 
amount of space 
between the display 
ports and the case 
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MEE Project Showcase | REACHY 


Reachy 


Meet the expressive and flexible open-source robot 
powered by a Raspberry Pi, David Crookes reaches out 











Pierre 
Rouagnet 


Pierre Rouanet 
studied human- 
robot interaction 
and Al for eight 
years in the INRIA 
Flowers research 
lab, where he 
obtained his PhD. 
He co-founded 
Pollen Robotics to 
imagine new 
robotic creatures. 


pollen-robotics.com 


Reachy played 
tic-tac-toe against 
humans at CES 2020, 
running entirely on 
Raspberry Pi. Reachy 
would image-analyse 
the board, recognise 
the pawns, and use 
simple Al to choose 
what to play next. It 
would use higher- 
level control to grasp 
a pawn and place it 


you’re likely to love to bits when you first 
set eyes on it. Blessed with futuristic styling 
and able to carry out many tasks with precision, 
it can interact with the environment and with us 
humans, making for a rather endearing creation. 
Which part of Reachy you’!l love, however, will 
mostly depend on the configuration you decide to 
buy — assuming you have enough money, given 
that the prices start at €9990. 
The basic model, for instance, comes with just 
a torso and one arm, while ‘expressive’ adds a 
Johnny Five-like head. An advanced option gives 
Reachy an extra arm, but in each case there’s a fine 
heart beating inside: a Raspberry Pi 4 running the 
Raspbian operating system. 


GS ay hello to Reachy — a humanoid robot that 


Ideal choice 

According to Pierre Rouanet, co-founder and CTO 
of Reachy creator Pollen Robotics, the decision to 
use Raspberry Pi 4 came after much debate. “We 
wanted to provide a simple and well-known setup 
with a supportive community that would let our 
users quickly understand, adapt, and modify the 
basic tool we were providing. Raspberry Pi has 
always been a very good solution for this.” 
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Reachy is open-source and developers can 
program it using Python, which opens up the 
possibilities of what it can potentially do. Indeed, 
Pollen Robotics initially created the robot to help 
researchers study arm-control in humans, but it’s 
evolved a lot since. 

“When we started Reachy in 2016, our former 
researcher colleagues had wanted to see how an 
amputee could easily control a prosthetic arm, 
and they needed something that could closely 
reproduce human motion and shape,” Pierre says. 
“But we developed new features, including using 
machine learning for control. We also wanted to 
work on its ease-of-use to extend the range of its 
potential users.” 


MWe developed new features, 
including using machine 
learning for control @ 


To that end, Pollen Robotics has pre-installed 
its own Python API and some extra tools for 
communicating with all the motors and sensors via 
USB-to-serial communication. 

“{Raspberry] Pi is actually running the whole 
synchronisation loop that retrieves all of the 
sensors values, and it publishes new commands 
for the effector (it runs at ~100Hz for Reachy, 
which is higher than most synchronisation loops 
in humans),” says Pierre. “On top of that, we runa 
higher-level application.” 


Machine learning 
Key to the robot is its built-in artificial 
intelligence. “We wanted to provide high-end 
and efficient tools for machine learning,” Pierre 
continues. “Our users require lots of power to 
perform analysis from the sensors, such as live 
object recognition and tracking, voice recognition, 
complex trajectory generation, and so on.” 

As luck would have it, work on Reachy coincided 
with the arrival of the Google Coral AI accelerator 


The arms have 
seven degrees of 
movement, with five 
fingers on the end 





and the new USB 3 ports in Raspberry Pi 4. “It was 

perfect timing,” says Pierre. “We could run all the 

machine learning we needed, while still providing 

a Simple ready-to-use setup and on top of that, we 
don’t need to rely on a cloud service.” 

Pierre says Reachy currently shines best when 
it is manipulating simple objects and interacting 
with humans. As such, it’s primarily intended 
for use in food and customer service, research, 
and development. But Pollen Robotics envisages 
a lower-cost version for hobbyists at some 
stage which would make for a rather exciting 
development for the Raspberry Pi community. 
“This is definitely something that I would like to 
encourage and see emerge,” Pierre says. 





A 2GB Raspberry Pi 4 
dU laysmaccls)ele)i-lam-lare! 
makes use of an open- 
source Python library 








Reachy is modular, with 
additional parts such as 
the expressive head and its 
nV eMer-\aal=)¢- (om ce) me) osX-1aU/ ale) 
Valo Maatclalieleltcliiale 


Reachy is 
designed to be 
plug-and-play 


It includes a 
microphone 
and speaker 


The innards are 
covered by fabric 


Google's Coral 
Al accelerator is 
also inside 


Only a handful are 
initially being made 


The software, design 
of all 3D parts, and the 
data used to pre-train 
Reachy on some tasks 
are all open-source 
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MS) Project Showcase | EL CARRILLON 


El Carrillon 


Tired of hearing the same tune year after year, two 
makers hacked the bells of gn enormous tower to 
ring the changes. Rosie Hattersley hears how 








M 


until they’re shared by us. 

The El Carrillon project, however, could hardly 
have made a more public entrance. In September 
2019 it was a focal point of Argentina’s 49th 
annual Fiesta Nacional de la Flor (National Flower 
Festival), where its newly overhauled bell tower 
proudly rang out a brand-new, Raspberry Pi- 
enabled tune. 

Many years ago, festival organisers created 
custom hardware with a PIC (programmable 
interface) microcontroller to control 18 tuned 
bells. Each bell is associated with a musical note, 








Mariano | } al 
Martinez Peck from A3 to D5 with all the semitones. Until its 
& Gerardo long overdue update, the tower’s 18 bells had 
Richarte 


Buenos Aires-based 
systems engineer 
and instantiations 
software specialist 
Mariano enjoys 
Raspberry Pi- 
based loT projects. 
Gerardo founded 
satellite and 
geospatial solutions 
company Satellogic. 
Raspberry Pi and 
Arduino reignited his 
love of electronics. 


@MartinezPeck 
satellogic.com 


A The El Carrillon bell tower forms a striking backdrop to the 
flower festival and other cultural events 


68 | The Official Raspberry Pi Handbook 2021 


ost Raspberry Pi projects we feature debut 
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rung the tune to Ayer, also known as Yesterday 
by The Beatles. They now have a brand-new 
repertoire of MIDI-based tunes, including the 
theme from Star Wars. 

For Gerardo Richarte, the originator of the 
project, there was a little extra pressure: his dad 
is on the board of the NGO that organises Fiesta 
Nacional de la Flor, and challenged his son to come 
up with a way to update the bells so different songs 
could be played. 


Ringing the changes 

With the challenge accepted, Mariano Martinez 
Peck explains, “We chose Raspberry Pi because 

it was inexpensive, yet powerful enough to run 
Linux, Python, and VA Smalltalk. We could find 
ready-made HATs that actually matched the pinout 
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A USB hub connects Raspberry ? | , * 
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> Hoses driving 
pressurised air to 
the pistons needed 
overhauling 


M A website that allowed , | ; ee Ua a me > Identically mapping 
es the bells using an 


control configuration, and a) Pak i Ww bes ‘LED piano’ helped 
playback of MIDI songs on > : with testing 


i . f 7 — : > They used 
the bell tower @ | — } ee ent MIDI 


software to check 


of the existing flat cables without much hacking, : | : the tunes 
and only a minimal amount of other hardware , a 
was needed. In addition, there was plenty of 
documentation, materials, tutorials, and GPIO 
libraries available.” 

The project aim was to be able to run a mobile- * - 
friendly website within Raspberry Pi Zero that ~ = ime. J eee: besa > Having a fixed 
allowed control, configuration, and playback a a Bie = deadline drove the 
of MIDI songs on the bell tower. “In addition, ee makers on 


> The attached 
keyboard can 
record the chimes 
performances 
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AKMS20 


A MIDI keyboard is connected to the setup, enabling a user to play live and record songs 
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To test the setup away from 
the bell tower, a piano layout 
of LEDs was created, each LED 
representing a note / bell 


we wanted to allow live playing from a MIDI 
keyboard,” says Mariano. The project developed as 
a live test and iteration update, but the final build 
only came together when Mariano and Gerardo’s 
moment in the spotlight arrived and El Carrillon 
rang out the first new tunes. 


Coding a classic 

The decades-old chimes were controlled by 
assembly code. This was superseded by Python 
when the team made the switch to Raspberry Pi 
Zero. Mariano explains, “Raspberry Pi allowed 
us to use Python to directly interface with both 
the old and new hardware and get the initial 
project working.” 

However, the Python code was itself replaced 
by object-oriented VA Smalltalk code - an 
environment both Mariano and Gerardo are 
adept at using. Mariano says, “Smalltalk’s live 
programming environment works really well for 
fast, iterative development and makes software 
updates quick and easy without the need for 











ELCARRILLON | Project Showcae 





Make your own chimes 





01 Originally, the bell tower code was written 

in assembly language and there was a 
chip on the board labelled ‘Ayer’ (Spanish for 
‘Yesterday’) that held a rendition of The Beatles 
song. Unfortunately, this was the only song available 
for playback. 
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A Raspberry Pi Zero, two IO Pi Zero expansion 





ME! Carrillon's bells can now play WF boards (each with an MCP23017 GPIO 
expander), and the bells’ pre-existing driver module 
gn V M | a | fi | PON R gS D b QA Ty p |, On e th A were connected together. Luckily, the power driver 
. board and the flat cables could remain untouched 
notes of th P SON Q WI | | b P md D D QA e and be reused. The pinout could be easily adapted 
to the IO Pi Zero boards by just soldering right- 
Co the tuned bells 0) angled headers to them. 


tes tPulseCoapleted 
pulserForMillLiseconds: 


recompilation that lower-level languages [such as 
assembly or C/C++] would need.” 

El Carrillon’s bells can now play any MIDI 
file on Raspberry Pi, and the notes of the song 
will be mapped to the tuned bells. However, as 
the testing process revealed, some songs are 


ina! 
more recognisable than others when reproduced Warning! 


Heavy objects 





on chimes. 
A final feature enabled Gerardo to bag some Church bells can weigh 
brownie points with his father-in-law. He recently Mi aaa teh 03 None New Wate Were eine) Sones, VL! 
added a web interface for controlling, configuring, by specialists. Sel SHES CLIP IIEN nen Neel lesci El elnfel ane 
; notes of the song will be mapped to the tuned bells. 
and playing songs, meaning the bells can now be magpi.cc /churchbells 


The code to control the chimes (along with more 


controlled remotely and the song selected viaa detailed instructions) can be found magpi.cc/carrillon. 


smartphone app. UH 
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ES) Project Showcase | BELLAGIO WATER SHOW 





Bellagio Water Show 


This miniature fountain features water jets 
synchronised to music. Phil King dives in 





Nick Rogness 





Nick works in the 
telecom industry, 
but his true passion 
is spending time 
with his family 

and taking on 
challenging projects 
as an avid maker. 


magpi.cc/bellagio 





Warning! 
Electricity & water 


Take extra care when 
combining electricity 
and water in a project: 
the two should be kept 
well apart! 


magpi.cc/ 
electricalsafety 





hen his employer wanted a Las Vegas- 
W themed float for the local parade, Nick 

Rogness was approached by the team for 
engineering assistance. “The decision to recreate the 
Bellagio water show started out as many good ideas 
start... a joke during a brainstorming session!” he 
recalls. “I knew it was technically possible in principle 
but would require overcoming some challenging 
engineering hurdles.” 

Nick had just 30 days to come up with a technical 
solution to recreate the water show. “In reality, it 
ended up taking two weekends of assembling the 
hardware and two weekends of writing the software,” 
he says. 


Pump it up 

A pump pushes water from a reservoir (children’s 
paddling pool) through PVC piping attached to water 
solenoids connected to sprinkler tubing pointed up in 
the air. A Raspberry Pi controls the solenoids, creating 
the effect of water jetting out in sync with the music 
being played. 

“A total of eight solenoids were connected back 
to a mechanical relay, which in turn was controlled 
by Raspberry Pi,” says Nick. Seven out of the eight 
solenoids were connected to brass reducers to fit into 
garden sprinkler tubing. The eighth solenoid was 
a pressure control (relief) valve, which was used to 
control back pressure in the system. 

“When I wanted to ‘fire’ one of the seven solenoids 
to shoot water, Raspberry Pi would close the pressure 
solenoid,” explains Nick. This built up pressure 
in the PVC pipe, at which time Raspberry Pi would 
trigger a relay to open the desired solenoid so a jet of 
water would shoot out. “This was required to get any 
distance with very little water. I also didn’t want to 
burn out the pump, so the relief valve was open when 
no other solenoid was open.” 


Water music 

The music is synchronised to the solenoid firing by 
using FFT (fast Fourier transform) analysis performed 
on the audio in real-time. “I wrote a sequencer in 
Python to perform the analysis and determine which 
solenoids to turn on and off, based on a config file 
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A Attached to half-inch PVC piping, each 12V DC water solenoid 
is connected back to the control board by way of a mechanical 
relay, operated by Raspberry Pi 


which maps high fidelity signals (bass, mid-range, 
etc.) to particular solenoids or solenoid groups,” 
says Nick. “In summary, you just put WAV files in 
a songs directory and start the Python code, which 
did all the heavy lifting in real-time.” 

One technical challenge was solving the timing 
discrepancy between the solenoid firing water and 
the musical note being heard by the audience. “The 
water had to be shot out of the jets approximately 
600 ms ahead of the audio for the water to appear 
to be in sync with the music.” 

Another issue was Safety, as mixing water and 
electricity can be hazardous. “The power for the 
system was a12V automotive battery,” reveals 
Nick, “so I used fuses to protect things, just as 
you would find in a family vehicle. I also tried 
to keep the dangerous gear out of reach of the 
general public.” 

Everything went well on the day, albeit with 
a few bugs: “There were certain sequences of 
musical notes where the FFT analysis would 
produce changes too rapidly for the back pressure 
and corresponding solenoid firing to produce much 
of a water jetting effect.” The result was a variance 
in water height from song to song. 

“T rode on the float during the parade, so the 
public reaction was the most rewarding part of the 
project for me,” he adds. “After people figured 
out what they were looking at, the responses 
ranged from laughter to astonishment. The public 
response made my day and all the efforts of the 
team worthwhile!” 


Project Showcase 
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1. a A side view of the finished project on the 
back of the float, ready to join the parade 


Eight solenoids were aS = 

connected back to a J Protected by a case, a Raspberry 
. Pi 3 runs the software, including 

mechanical relay, which real-time music analysis and 

, controlling the water jets 

In turn was controlled 


by Raspberry PI 





=—_ 


A single solenoid 
water jet could 
shoot well over 8m 







The water used is in 
a closed system 


Software is 
available on GitHub: 
magpi.cc/ghbws 


Hed never worked 
with water in an 
electronics project 


Future projects 
include a security 
drone and snow- 
removing robot 


Nine relays are used: one 
Ko Moxo)al ice) mial-muc-1k-1 a olUtan] oy 
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A waterproof fuse box is used to safely 
distribute power from a 12V car battery 
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Raspberry Pine 


Think all computers are boring black boxes? You've not seen Raspberry 
Pine, the desktop computer with a bit of class, PJ Evans gets all fancy 





Neil Shepherd 





Neil has been 
working with 
computers since 
the 1970s. Upon 
retiring, he joining 
U3A (University 
of the Third Age). 
Their electronics 
group rekindled 
his interest in 
Raspberry Pi. 


w The rear is an exposed 
collection of controller 
board and, of course, 
the project's 
Raspberry Pi 3B+ 





annoyance and hassle, but not Neil Shepherd, 

who saw nothing but opportunity. After a brief 
respite at the bottom of his wardrobe, Neil dismantled 
the laptop looking for useful spares and maybe some 
inspiration. He hit upon the idea of building a desktop 
computer that would fit in with the surrounding 
furniture, rather than being yet another drab black 
box. “What do you do with a17-inch LCD panel? Put a 
frame round it,” he says. “It’s got to be different, so 
wooden... pine to be precise. Add a Raspberry Pi 3B+ 
and my love of awful puns gives us Raspberry Pine.” 


T o many, a broken laptop would be a source of 


Wood-n't it be nice 

The screen is mounted in a custom pine frame and 
stand. The frame is built using strips of small pine 
architrave backed by pine strips, offset to give a 
suitable rebate for the panel to fit and hiding the 
border. The side supports are modified pine staircase 
spindles. A Perspex sheet is used to mount the 
electronics and, when powered, the panel backlight 
creates a warm glow. Finally, short lengths of foam 
draft excluder secure the panel sandwiched in 

the frame. 

The LCD panel has a driver board with HDMI, DVI, 
and VGA inputs. This is connected to the project’s 
Raspberry Pi 3B+ by a short HDMI lead, with left- and 
right-handed adapters. This caused a headache for 
Neil: “I think the biggest challenge was sourcing the 


LCD panel driver board from a UK supplier on eBay. 
Unfortunately, the only documentation you get is 
from the tiny screen printing on the board itself.” 
The rest of the electronics supply and manage 
power. The main supply is the original PSU brick 
from the donor laptop, providing 19.5V at 4.5A. 
Two DFRobot PSU boards are used to drop the 19.5V 
to 5V for Raspberry Pi, and 12 V for the LCD driver 
board, enough to power the backlight. 
There is also the option of battery power, from 
three Li-ion cells recovered from another laptop. 
A battery management system (BMS) board sits 
on top of it and ensures the cell charge states are 
balanced. Finally, a charger board provides the 
correct constant current and voltage charge profile. 


M What do you cdo with a 
17-inch LCD panel? Put a 
frame round It. It's got to 
be different, so wooden... 
pine to be precise 


A tree-mendous result 
The result is a very different take on the classic 
desktop project: a computer that would look just as 
at home on the bedroom dressing table as it would 
in the study. Neil was certainly pleased with the 
results, as well as an unplanned effect: “The choice 
of raspberry-coloured Perspex as the support 
for the electronics produced a pleasant surprise. 
When powered on, the LCD backlight gives a 
raspberry glow.” 

Regarding planned further refinements, he 
tells us: “When the Raspberry Pi 4B+ gets the 
update to boot from USB, there may be a rebuild 
to refine the layout so the SSD doesn’t stick out 
the side. Currently, the donor laptop keyboard is 
being developed with an Arduino Due and more 
pine. There are thoughts of matching mouse 
and speakers.” {/] 


= Searing 








A salvaged 17-inch 
LCD screen froma 
dead laptop 


Tale Britain defends 
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parts normally used for ) 
skirting and staircases 
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Currently a standard wireless 
keyboard is used, but a pine 
keyboard is in the works! 


Neil has thoughtfully added 
a breadboard and control 
switches for ease of use 


A matching keyboard, 
also from the laptop, is a 
work-in-progress 


RASPBERRY PINE: 





a Lili 








The screen is 
a 2007 HP 17 
laptop panel 


The computer will 
soon be joined by 
a pine-encased 
keyboard 


You can run the 
computer from the 
mains or battery 


The pine used is 
off-the-shelf, with 
small modifications 






Neil's next project 
is to record the 
animal that 

keeps pooing in 
his garden! 
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Instaclock 


Designed to celebrate gd new home, Instaclock 
uses two Raspberry Pi computers to great 
visual effect, Rosie Hattersley finds out more 








< 


Riccardo 
Cereser 


Riccardo is a 

UX designer for 
logistics company 
DFDS. After growing 
up in Italy and 
Dublin, he moved 
to Copenhagen to 
study interactive 
design. He's a 
keen illustrator 
and Raspberry Pi 
retro gamer. 


@ricently 


mind! Copenhagen-based illustrator and UX 
designer Riccardo Cereser was about to move 
into anew apartment with his girlfriend, and was 
determined his new home would have a unique 
timepiece. Instaclock (magpi.cc/instaclock) is 
the result. 

Having studied at the Copenhagen Institute of 
Interactive Design, Italian-born Riccardo was keen 
that his new apartment would include an object 
that reflected his skills. He began sketching out 
ideas in Photoshop, starting with the idea of images 
representing numbers. “A hand showing fingers; a 
bicycle wheel resembling the number 0; candles ona 
cake; or the countdown numbers that appear in the 
beginning of a recording...” he suggests. 

Having decided the idea could be used for an 
interactive clock, he quickly worked out how such 
an image-based concept might work displaying the 
hour, minutes, and seconds on displays in three 
wooden boxes. 

Next, he set off around Copenhagen. “TI started 
taking photos of anything that could resemble a 
number, aiming to create sets of ten pictures each 
based on a specific theme,” he recalls. “I then 
thought how awesome it would be to be able to switch 
the theme and create new sets on the go, potentially 
by using Instagram.” 


T here’s nothing like a deadline to focus the 
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a standard timepiece 





This, Riccardo explains, is how the project 
became known as Instaclock. He was able to 
visualise his plan using Photoshop and made a 
prototype for his idea. It was clear that there was 
no need to display seconds, for example. Minute- 
by-minute updates would be fine. 


M | started taking photos 
of anything that could 
resemble ag number @ 


Getting animated 

Next up was figuring out how to call up and 
refresh the images displayed. Riccardo had some 
experience of using Raspberry Pi, and had even 
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Ikea file organisers make ideal 
frames to hold the displays 





> Digital sketching 


Pressing the button switches tools were 
the image set used to display || invaluable for 


idaCeMalelaaloxsesKelabiatclasveg=\-10 planning this 
project 


> Many of the items 
used to build 
Instaclock came 
from Ikea 


> Riccardo got 
Instaclock's ‘off 
switch’ code from 
The MagPi 


> He is thinking of 
adding an alarm 
function next 


> He's pondering an 
animated weather 
cartoon version, too 


4 Stills from cartoons and 
illustrations work really 
well as a visual device 
and add to Instaclock’s 
quirky appeal 
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Build a cool clock 


Each of the Instaclock’s twin screens has a Raspberry 
Pi 3 Model B controlling image delivery to it. You'll 
need to adapt or build a box to house each screen, 
and drill holes to accommodate cables and ventilate it. 





01 Attach the LCD HAT's ribbon cable to the 
screen's input port. You might also want to 

use magnets to help secure the screen in place in its 

display box. Make sure all the screens are grounded! 





02 Install Raspberry Pi OS on 8GB microSD cards, 
boot up, and connect each Raspberry Pi to 
your wireless network. Set a script to sync folders via 
Dropbox and use the cron scheduler to change the 
displayed image every two minutes. 












tome ey ry res gee 8 Cte Lega . Deep 


a Sarl Procedaing gheteh at Fi atari. 
wee Lee ere en ta eed @ rte 
a mit an 
Se Pre 1g ee a cde bo ee ey ee fee eT e- -  Lb 
Dn Epitome in Pm CL, Fee gaia a ogee claw ses ey ergo oy Poe Sede: Peep Pik 


foes seared Cert pan etc ene, [re ot gene Us es Be eg ey et 
Te ee eer rey 
abhart 










er ee es eee i ee ee 


oped a ee eee ee es ee" i 









fiom. Lag DiS 


(eerie eer eg ee ee eee be ee eh ei erin 
mm Bay scare Mar [ppt meng cad ore: a gn (ee Fr preg Sn gp nk, 






lo 
a] 
ree tape ral ee Fee es ey ee dere Be eg pee ee ad Pl 
Ly ai (Cy eo) ee ee ere ee es |e ee ee ee ee 
my wpm Pe ee el a oD ee hy te el age fe 
ee eg ee ae ee Se TS ay SS 
Li +) 


Pe Rh Soe eg cee caer be ee fe a ee? Seid | a eT 





Set the Processing sketch to launch at 
startup (see magpi.cc/process). Disable the 
screensaver (so it doesn't interrupt the clock script) 
and hide the cursor. Back up the microSD card, then 
switch on. Repeat steps for the other Raspberry Pi. 


78 | The Official Raspberry Pi Handbook 2021 


Graphics from classic 
games may be used 
to tell the time - can 
you work it out? 





made a RetroPie games console. He also had a friend 
on the interactive design course who might just be 
able to help... 

Creative coder Andreas Refsgaard 
(andreasrefsgaard.dk) soon got involved, and was 
quickly able to come up with a Processing sketch for 
Instaclock (magpi.cc/instaclockgit). 


M They also added a rule that 
shuts a screen down if the 
Dutton on top of It Is pressed 
for ten seconds or more @ 


Having spent dozens of hours looking into how an 
API might be used to pull in specific images for his 
clock, Riccardo was grateful that Andreas immediately 
erasped how it could be done. Riccardo then set 
parameters in cron for each Raspberry Pi used, so the 
Instaclock loaded images at startup and moved on to 
the next image set every ten seconds. 

Because Riccardo wanted Instaclock to be as user- 
friendly as possible, they also added a rule that shuts 
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4 











A Photographing distinctive details was 
fok- lame) mdalomele) e\-1-| me) mnalom e)ge)(-1e1! 


a screen down if the button on top of it is pressed 
for ten seconds or more. The script was one he got 
from The MagPi (magpi.cc/offswitch). 


Assembly time 

One of the most fun aspects of this project was 
the opportunity to photograph, draw, or source 
online images that represent numerals. It was 
also the most time-consuming, of course. Images 
reside in Dropbox folders, so can be accessed from 
anywhere. Deciding on a Suitable set of screens 
to display them, and boxes or frames for them, 
could also have dragged on but for an impromptu 
visit to Ikea. Riccardo fortuitously found that the 
Waveshare screens he’d selected would fit neatly 
into the store’s Dragan file organiser boxes. He 


was then able a laser-cut PLOLECHIVE overlays Visitors to Riccardo’s apartment have been intrigued and challenged by the 
secured with tiny magnets. displays, which even feature the occasional maths problem 
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CNC Etch-A-Sketch 


Engineer Quint Crispin has been drawing lots of attention 
to his latest project, as David Crookes discovers 








Quint 
Crispin 


Quint is an engineer 
who loves to play 
around with cool 
builds. He created 
his Etch-A-Sketch 
project with the 
help of his young 
son, who assisted 
with its fine-tuning. 


magpi.cc/cncetch 


The project is powered 
by four lithium cells 

in conjunction with a 
battery management 
system to give five 
hours of operation 


<= 
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or 60 years, the iconic Etch-A-Sketch 
c toy, invented by French electrician André 
Cassagnes, has provided a blank canvas 
that has both enthralled and infuriated. Many 
of us will go no further than drawing some simple 
straight lines and shapes. But there are some 
amazing practitioners out there (check out Jane 
Labowitch and Dave Roberts) who can generate 
incredible works of art. 
Quint Crispin admits he is not one of them, 
but, with a bit of ingenuity, the engineer has 
nevertheless found a way to unleash his creativity. 
He has devised a machine to perform the magic for 
him, using a Raspberry Pi 3 computer connected to 
a CNC HAT made by Protoneer. This has enabled 
two NEMA~17 size stepper motors to be controlled 
— hooked, as they are, to the Etch-A-Sketch’s 
two knobs using a belt attached around blue 
timing pulleys. 


Shaking things up 

“T had no idea the Raspberry Pi was so powerful,” 
he says. “But when I discovered it was capable of 
driving stepper motors using programs such as 


*F 
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A For the creation of stop-motion videos, the camera sits behind 





black fabric to prevent reflections, and each image is drawn 
1 to 2mm apart for smooth footage 


bCNC, I knew I'd found my solution for a portable 
CNC Etch-A-Sketch.” Indeed, his use of our 
favourite computer meant he could produce a 
wireless unit that was so light and sturdy, it could 
also be picked up and shaken to clear the display 
without causing any damage. 

“Other projects have connected stepper motors 
to an Etch-A-Sketch, but the makers have quickly 
found they have to take the whole thing apart 
just to reset the screen,” Quint tells us. “That’s 
something I’ve never had to worry about because 
I spent a lot of time designing and producing a 
strong frame. It meant more work up front, but 
was well worth it in the long run.” 

Even so, the challenge didn’t stop there. As 
with all CNC machines (those which use software 
connected to a tool to automate control such as 3D 
printers), simple x and y co-ordinate commands 
are issued. “You’re basically telling the machine 
‘so here, go there, now here, now there’ using 
commands known as G-code,” Quint explains. 
Coding is, therefore, crucial. 


Turning things around 

For this, Quint used variations of the G-code 
command G1, noting the required x/y position and 
the required speed. “As an example, G1 X40 Y6o 


Project Showcase 


With a design ready in the free program 
0101) (One CRorole(~Mer- lam el=e-\-)8] xem dal) 
Raspberry Pi to activate the stepper 
motors to create it on the Etch-A-Sketch 


Using small enough line 
segments, you can even 
draw a circle! 


F400 means go 40mm to the right and 60mm 

up at a speed of 400mm per minute,” he says. 
“Using small enough line segments, you can even 
draw a circle!” 

The first real problem he encountered was the 
looseness in the Etch-A-Sketch mechanism when 
changing directions. “You have to turn the wheels 
further than you think — if you mark an Etch-A- 
Sketch dial and bring it to the same spot from both 
directions, you’ll get about a1.5mm mismatch 
which can make your sketches look really poor. 
Most CNC software has ‘backlash compensation’ to 
account for this, but bCNC does not. Fortunately, 

I stumbled on a free program called NoLash 
that adds backlash compensation to the G-code 
program itself. You just tell it how much to 
compensate for and it does the job for you.” 

Now, by firing up bCNC, Quint can create an 
image and have it replicated on the Etch-A- 
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The project cost 
less than $200 


It uses 3D printer 
stepper motors 


The frame ts light 
enough to shake 


Raspberry Pi is 
running bCNC 


It also wears a 
CNC HAT 


For fun, Quint decided to play around with stop-motion video. 
He'd create an image, take a photo of the Etch-A-Sketch 
screen, shake, and create another image 


Sketch screen with the knobs being automatically 
manipulated. It has also allowed for some very 
elaborate designs, which have impressed all who 
have seen them being created. “Once I got it 
figured out, everything worked really well,” he 
says. “The experience has been magical.” 
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Solar-powered 


Raspberry P1 Camera 


Kaspars Dambis has put an eye in the sky using his Raspberry Pi, as David Crookes explains 





Kaspars 
Dambis 





Kaspars iS a 

web developer 
and electronics 
enthusiast who 
enjoys creating 
simple, low- 
power connecting 
projects that use 
microcontrollers. 


kaspars.net 





Alert! 
Batteries 
included 


Please take care with 
rechargebable car 
batteries: 
magpi.cc/carbat 








is not for the faint-hearted. Neither, on 

reflection, is climbing up a tree to installa 
solar panel and a CCTV camera, and yet Kaspars 
Dambis has done both. 

One thing led to another. “I wanted to monitor 
the construction site remotely because we 
currently live 100 kilometres away,” he says. But 
rather than buy an off-the-shelf CCTV system, 
he purchased a dummy camera case, creating his 
own way of capturing images using a Raspberry Pi 3 
Model B computer. 

“From the start, I wanted to keep watch over the 
building of our home and create a time-lapse of 
the process for fun,” explains Kaspars. “I knew it 
had to be a battery-powered and wireless system 
because getting mains power to the device wasn’t 
going to be possible on a site like that.” 


3 uilding a new family home from scratch 


Seeing the light 
Kaspars picked up a lightweight 18 V 5A solar panel 
that was marketed as being perfect for charging 








A Fitting the system in a tree prevents tampering and makes 
the setup look less Intrusive 
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boats and cars. This, he figured, would gather 
energy from the sun to charge a12V battery and, 
with the use of an inexpensive 12 V-to-5 V buck 
module, power the Raspberry Pi 3 Model B and an 
eight-megapixel Raspberry Pi Camera Module v2. 

At first, Kaspars attempted to build a case from 
a generic project box, but he found it was relatively 
difficult to find decent clear glass for the camera 
window. “I then noticed a dummy security camera 
in a local hardware store which had perfect clear 
elass on one end, and full weather projection for 
the battery-powered LED system,” he says. And 
this worked a treat. 


™ The weather protection 
proved to be great, 
even during the 
winter months @ 


Using hook-and-loop fasteners, the Camera 
Module could be attached to Raspberry Pi’s case 
which, in turn, was secured to the inner housing 
of the camera casing. “The weather protection 
proved to be great, even during the winter months, 
and [my] Raspberry Pi never had issues with the 
temperature ranges either.” 

To get as much energy as possible, the solar 
panel and the 12 V battery were positioned up 
high on a wooden frame, with the security camera 
device attached too. This wasn’t ideal. “The 
battery was heavy and the frame broke during 
a storm, so I created two separate frames: one 
for the solar panel with the camera unit below 
and another for the battery and the solar charge 
controller,” he says. 


Monitoring from afar 
Kaspars configured his Raspberry Pi to connect 
to a nearby WiFi access point via a standalone 


Vakeo Raqueiated 
ee ae 
_—_ 





A A12V,7Ah lead-acid battery has been sufficient to provide 
an average power consumption of 2W since it can provide 
84 watt-hours of energy 


modem plugged in at his neighbour’s 

house by setting the access credentials in the 
wpa_supplicant.conf file in the root of the SD 
card. “The most basic time-lapse functionality 
was added using a simple Bash script which takes 
a picture from the raspistill tool at the desired 
time intervals and stores it on the SD card.” 

Connecting remotely involved setting up 
an external server and using the SSH tunnel, 
autossh. When up and running, a photo is taken 
every hour and it can be downloaded using SCP 
when connected to the same WiFi access point as 
Raspberry Pi. Video capture and real-time feeds 
can also be viewed in a browser. 

It all means Kaspars is now able to remotely log 
in to his Raspberry Pi and eventually see his new 
home come into being. There is still an element 
of fear, though. “The ability to connect toa 
Raspberry Pi which is up in a tree powered by the 
sun and 100 km away is a special feeling,” he says. 
“Every command you type in the terminal has the 
potential to break the WiFi connection — and the 
cost of each mistake is a 200 km drive to restart 
the device.” 





SOLAR-POWERED RASPBERRY PI CAMERA | Project Showcaae 


— 














Tamecsiaye petal 
Tal=>delslasihViemelelaalaanys 
case, the resulting 
ai at-mere)aa)ece)al-1ais-teem lacetlelellale | lolul|Ke Mat-\oMaar=m olelalers 
the solar panel and the battery ty ro} im Vote) ale MUL Come! 
in its waterproof casing - are ~ security camera 
Yisy ore ake k- Mu celele(=\amic-laatom-lale| 


placed outside 


A Raspberry Pi 3 

Model B computer 

with a Camera 

Module requires 
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use a Solar panel > The project cost 
Kaspars $222 


> He's also paying 
for 10GB of 
monthly data 


> It should run 
for two days 
without charging 


> Getting it up a 
tree was the 
hardest part 


>» All cases need to 
be waterproof 


ll 


A Dummy security cameras can be picked up cheaply 
- this one cost Kaspars just $8 
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Flying Saucer 
Clock and NAS 


If you're thinking of fashioning yourself a new clock, have you considered 
one with an extraterrestrial twist? Nicola King has a close encounter... 





» The saucer was 





Harry 
Tansey 


A software 
engineer, DlYer, 
and maker, with 
interests in Music 
visualisation, XR, 
3D design and 
printing, Raspberry 


Pi, microcontrollers, 


electronics, and 
blinky LEDs. 


planetzarg.com 











designed in Fusion 


360 and its numerous 


parts were then 
3D-printed; the STL 


been considering creating some form of 

clock project for a while, when he was 
inspired to make something that did more than 
just tell the time. “I have been experimenting 
with WS2812B LEDs (aka NeoPixels) over the past 
few years and knew they were going to be a key 
component,” he says. “When my NAS (network- 
attached storage) box started playing up last year, 
I knew I had to make or buy a replacement. Given 
that both a NAS and a clock tend to be on 24/7, | 
started toying with the idea of ring of 60 LEDs as 
clock segments and arranging the NAS components 
(Raspberry Pi, HDDs, and PSU) inside.” 


U K-based Harry Tansey is a maker who’d 


Print perfect 

So, the concept for the Flying Saucer Clock was 
born, and Harry set about designing a prototype 
using Fusion 360. Given that he was going to 
3D-print the clock, he knew it was critical to get 
the design as precise as possible, in order to save 







files are on Thingiverse: 
magpi.cc/flyingsaucerstl 
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A Aside view of the saucer. Transparent segments are used to 


diffuse the LEDs, with light blockers between them for 
crisp separation 





both time and money with expensive, failed 3D 
prints. “Failure can be expensive when the weight 
of filament in the project is just short of 2kg! This 
equates to nearly 120 hours of printing time — or 
about four days using two 3D printers running 
simultaneously for around 14 hours a day,” 

he calculates. 

Harry also set himself another challenge: “It 
was Critical to give the pieces enough tolerance so 
they could be used straight from the printer and fit 
together with minimal surface finishing.” 

Despite a few hiccups with his first attempt, 
Harry pushed on, and the finished article is 
something to behold. So, how is it constructed? 
“The outer ring has 60 RGB LED segments 
constructed simply by cutting a length ofa 
standard WS2812B LED strip and mounted ina 
3D-printed holder with protrusions to keep the 
LEDs fixed in place,” he says. “Lighting one of 
outer LEDs red indicates the seconds, and a green 
one indicates the minutes. | found that lighting 
the two LEDs to either side of the minute LED 
improved the readability.” 

Harry also created an inner ring of LEDs divided 
into twelve segments, and one of these is lit in 
blue to indicate the hour. He then lit up some 
hour markers on twelve of the outer 60 LEDs, 
making it easier to track the positions of the 
minute and second LEDs. Harry chose a Raspberry 
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> The Flying Saucer 
is 400mm in 
diameter 


a 
Feigy Ue tu 


Pi 4 to drive the LEDs as he was “really excited by 
the capabilities of [its] full-speed Ethernet and 
USB 3 ports.” 

The Flying Saucer’s NAS file-sharing 
functionality comes by way of two 3.5-inch drives, 
secreted inside, and a fairly simple Samba setup. 
“T have created different file share areas for work, 
family members, and storage for my Linux-based 
satellite TV/PVR receiver,” reveals Harry. 


oe 


It's lit up by a total 
of 84 NeoPixels 


M Failure can be expensive 
when the weight of 
filament in the project is 
just short of 2kgq! @ 


The twelve body 
panels were 
printed in vertical 
orientation 


See how Harry 
made It here: 
magpi.cc/ 


Udderly ingenious! flyingsaucernas 


Harry says that the feedback from family and 


-_ Harry has around 
friends has been very positive, but, he’s not 


twelve Raspberry Pi 


finished there with his flying saucer. “There is 
another ring of twelve RGB LEDs on the bottom 

of the UFO. These all face inwards and the final 
effect runs these in a slow pulsating pattern. With 


boards around the 
house, including 
one controlling his 
central heating 


a semi-transparent cup that I borrowed from 

my daughter, it makes a really convincing beam 
effect that appears to ‘travel’ down the cup as the 
light intensifies. I am going to use this together 
with a 3D model of a cow for the ‘traditional’ cow 
abduction effect.” H 


<4 The two NAS disk 
drives and Raspberry 
Pi are housed within 
the saucer, powered 
by a12V PSU via 
three buck converters 
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Ms Project Showcase | CHAMBER: SOURDOUGH INCUBATOR 


Chamber: 
Sourdough 
Incubator 


Having issues with your sourdough starter? Read on and be inspired... 
here's a radical baker using his loaf. Nicola King delves into the dough 











Trent Fehl 


US-based Trent 

is a maker 

with electrical 
engineering training 
and a love for 
writing software. His 
personal projects 
are often inspired 
by his experiences 
outside of tech - 
most often cooking, 
hiking, and cycling. 


magpi.cc/chamber 





hen maker, and baker, Trent Fehl first 
W started making sourdough bread, he 

realised that keeping the starter at the 
correct, steady temperature could be a bit of a 
minefield. “I read all about different techniques for 
keeping a culture alive — of the different conditions 
to monitor, temperature was chief,” he tells us. 
“Bakers have all sorts of tricks to achieve that 
temperature. Some have a spot on their kitchen 
counter-top they like, others prefer an oven 
(turned off) with the light on, but many recommend 
specialised proofing boxes. What struck me was 
that only one of these options allowed you to set 
the temperature and you could only control to 
temperatures higher than ambient.” 


All you knead to know 

Trent decided to take on the challenge of designing 
a product to meet his culinary needs, and was 

sure that he wanted to incorporate a small Peltier 
cooler in his project, as his friend Scott Hutchinson 


A Ahardware block diagram of the system, 
showing how everything is connected 
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A The fruit of Trent's labours: a delicious sourdough loaf 


had given him the idea on a camping trip. “He 
happened to be a spacecraft thermal systems 
engineer and suggested using the Peltier cooler for 
both cooling and heating,” says Trent. “I thought 
this was so slick that I really got moving on the 
project when | got home.” 

So, how exactly does the incubator work? “The 
Chamber utilises a Peltier cooler, also known as a 
thermoelectric cooler, to either pump heat from 
inside the Chamber to the outside (cooling the 
interior) or to pump heat from outside the Chamber 
to the inside (heating the interior),” explains Trent. 
“The direction that the heat is pumped is simply 
controlled by alternating the polarity of the voltage 
applied to the Peltier cooler.” 

He changes the temperature in the Chamber 
with an H-bridge module driven by a Raspberry Pi 
Zero. So, if the temperature gets too high, the fan 
on the outside wall pushes the heat away, and if 
too cold, another inside fan pulls warm air in. This 
being Trent’s first Raspberry Pi project, he appears 
converted, saying the single-board computer “is 





yNaM=).4k-)ale)arclaremlaik=lalele 
fan are used to pump heat 
Taislale me)Oime)mal-mevat-laalel-\¢ 


just such a great tool for personal projects: there is 


an excellent community offering software libraries, 


lots of compatible hardware, and helpful guides.” 


You say sour, | say squer 

It’s true that bakers can buy proofing boxes, 

but Trent thinks that his incubator has clear 
advantages over commercially available 
alternatives. “The big advantage my chamber 
offers is heating and cooling in one package; plus 
it might be cheaper. Some of the off-the-shelf, 
heat-only options are almost $200 new, while 
mine is ~S180.” In addition, Trent’s invention 
can be used for other foodstuffs: “I enjoy baking, 
and I really enjoy eating bread, but I’d be lying 

if I didn’t say that the mad scientist aspect of 
harnessing the power of fungi and bacteria to 
create tasty foods didn’t draw me in... we’ve also 
fermented jars of garlic and jalapenos, sauerkraut, 







A Raspberry Pi Zero takes 
ig=ye\eollalesMagelaame-vanlel-ig-liela=) 
X=) alsve) gomelale Mere) aiace)tomtal- mre lars 


| realised there were more 
people with this problem 
than | originally thought 


and various peppers. I’m proud to report that 
everything has tasted good.” 

Trent demonstrated his Chamber at the 2019 
Hackaday Superconference, and got a brilliant 
response from like-minded makers. “Right at the 
start of my talk I said something like, ‘for those of 
you who maintain sourdough starters, you might 
be familiar with specific target temperatures but 
no means to control to those temperatures,’ and I 
noticed that a good number of people were smiling 
and nodding their heads. At that moment, | 
realised there were more people with this problem 
than I originally thought,” he says. 


Pe. 








~ — 2 


BMal-moslacclalmccianlelsie-laelas 
is shown on a mini OLED 
folfsyolk=\Vem alo elecjabelelarelals 
are used to select the 
desired temperature 


Trent is looking at 
turning the project 
electronics into 

a HAT 


The Chamber can 
keep a steady 
temperature 
between 16 

and 28°C 


The software 
for the project is 
written in C++ 


See the GitHub 
page for code and 
details: magpi.cc/ 
chambergit 


Trent is 
experimenting with 
machine learning 
projects using 
Raspberry Pi 
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ES) Project Showcase | DROPSTITCH 





DropStitch 


The joy of creating something wonderful - whether in code or another medium - can turn 
to despair without a means of rendering it. Rosie Hattersley qoplauds a new option 


fulfilling and mindful hobby that combines 


C reative crafting is all the rage and can be a 
easily with technology. A workshop 








Margaret Low 


Margaret Is director 
of outreach at 

the University 

of Warwick's 
Manufacturing 
Group, making 
extensive use of 
Scratch and CAD 
in her efforts to 
widen participation 
in computing 

and technology. 


magpi.cc/ 
dropstitch 


TurtleStitch uses a 
familiar block-based 
interface, So you can 
boost your coding 
skills while focusing 
on being creative 





using one example, TurtleStitch, at the summer 
2019 Raspberry Pi-hosted Scratch Conference 

in Cambridge was packed. It’s a popular visual 
means of using Snap! (magpi.cc/snap) and a great 
learning tool which will be made all the more 
usable thanks to the creation of DropStitch. 

After being created in TurtleStitch 
(turtlestitch.org), designs are printed using a 
digital embroidery machine, such as the one 
Margaret Low from the University of Warwick 
brought along to the Scratch Conference. 

Getting the designs on to her embroidery 
machine involved transferring them from a PC or 
smartphone to the device on a USB stick — a rather 
clunky option that meant the user had to be in 
the same location as the embroidery machine, or 
send it to someone to initiate the embroidery on 
their behalf. Margaret points out that frequently 
switching USB sticks can result in wear and tear on 
the embroidery machine USB port. 

After discussing these issues with other 
TurtleStitch demonstrators, Margaret came up 
with the DropStitch project in order to solve this 
problem. “It enables devices that normally read 
files from a USB drive to receive files wirelessly 
using Bluetooth file transfer (or WiFi) — so 


Turtlestitch - Coded Embroidery 


= C2 
— 





Run Turmlesiich! 
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A Margaret demonstrated the DropStitch system at the 2019 
Scratch Conference in Cambridge 


freeing them up from being tethered,” she says. 
DropStitch works with TurtleStitch and other 
embroidery programs (those supported largely 
depend on the embroidery machine being used). 


mM The free stitch cards 
provided by TurtleStitch 
provide Snap! tutorials @ 


Inspiring creative coding 

Margaret uses the industrial embroidery machine 
in the university’s engineering faculty’s workshop, 
demonstrating TurtleStitch and coding to students 
and visitors, and potentially broadening the appeal 
of an under-represented STEM subject. 

Because Margaret also regularly holds classes 
introducing schoolchildren to code using 
TurtleStitch, she knows only too well the issue of 
having to contend with a succession of USB sticks 
so that kids could print their designs. It’s a time- 
consuming drag! However, she enthuses about 
the software’s role in broadening the appeal of 
coding. Coding can be done on a tablet and laptop. 
The free stitch cards provided by TurtleStitch 


DROPSTITCH | Project Showcae 
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DropStitch uses a Raspberry HH 007) Embroidery 
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A TurtleStitch designs use Snap!, a block-based programming 
language, to create some Incredible geometric designs 





| | _ | M500 — f+] 
provide Snap! tutorials that result in impressive - spm FL3 


geometric designs and lettering, so you can | Return | memory | 


quickly go from being a beginner to producing 
impressive embroidery. 

If you don’t have access to an embroidery 
machine, you can send your completed design to : 
someone who does — something that DropStitch | Oluitel.a /:\eu ks 
makes appreciably easier. 

> TurtleStitch uses 








Smart thinking law ee Snap! a Scratch- 
Margaret explains: “The aim was to avoid some . 3 , a inspired language 
of the problems with USB memory sticks such as . . 
having sufficient USB memory sticks for the class, Once transferred to the embroidery machine, panei 
identifying files to be stitched, and the accidental images to be stitched can be previewed and lec a 
overwrites of files. DropStitch is based on The MagPi selected as usual from the touchscreen slowne 

article [by Dave Honess in issue 60], ‘Make a Pi 

Zero W Smart USB flash drive’ (magpi.cc/usbflash). > TurtleStitch sees 


DropStitch has some modifications [from the 
original] because Raspberry Pi Zero W and the 
embroidery machine can’t both write to the same 
USB partition at the same time.” 


Snap!'s pen as an 
embroidery needle 


> Margaret uses 


Essentially, it uses the embroidery machine’s rca - . 
USB port to add either WiFi or Bluetooth scnool outreac 
programmes 


connectivity and provides device discoverability 
and only needs a Raspberry Pi Zero W to do 


> Warwick University 
so. All the instructions to install and enable 


provides lots of 


DropStitch are provided on the tool’s webpages free TurtleStitch 
at magpi.cc/dropstitch. tutorials: 
Margaret is keen to help extend DropStitch’s magpi.cc/ 
warwickTS 


usefulness by making code available for others to 
customise: magpi.cc/dropstitchcreate. There’s 


even a form on the DropStitch homepage to request A TurtleStitch designs created by Warwick University can be 
embroidered onto T-shirts or bags or used to make homewares. 


support for a particular embroidery program. Hl Image: Helen Luckhurst 
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Alan Peaty 





Cloud architecture 
engineer Alan 
enjoys loT tinkering 
and inspiring his 
kids. He says: 
“Technology Is here 
to stay. We should 
all get to learn 
about it.” 


magpi.cc/ 
rosieredrobot 


WV The RioT Brick's live 
data feed 


RIoT Brick 


Long-distance running and a love of intrepid devices led one 
creator to embark ond project demonstrating that ‘true geekery 
and nature can co-exist’, Rosie Hattersley tries to keep up 


embers of his local running club are no 
Mi longer fazed when ultra-runner Alan 

Peaty cruises past with an unidentified 
extra item or three attached to his person. While 
some fitness fans go for the ultra-sleek look to 
minimise air resistance and extra weight, Alan 
regularly takes the opposite approach and brings 
a little something extra along on his treks on the 
Cotswold Way. 

Cloud computer engineer Alan regularly blogs 
about his Internet of Things inventions at 
mMmagpi.cc/rosieredrobot and has previously graced 
these pages with his Countdown-playing robot (see 
magpi.cc/countdown). “Building intrepid devices | 
can take along with me outdoors is the perfect way 
for me to combine my interests in one fell swoop,” 
he says. “I have been known to go running with 
3D-printed devices attached to my legs (although 
understandably only at night) to gather data on my 
leg movement.” 








i GPS 
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A The Brecon Beacons, where Alan tested his project to 
track his progress during a gruelling running race 


In September 2019, Alan put his movement- 
sensing project to the test in a gruelling endurance 
race across the Brecon Beacons in Wales. He 
created the ‘RIoT Brick’ (Rosie Internet of Things 
Brick) so his family - some as far away as Australia 
— could remotely track his progress. Hooking 
himself up in this way also enabled Alan to monitor 
basic environmental conditions during what would 
be “a very, very long day!” 


M | have been known 
to go running with 
3D-printed devices 
attached to my legs 


Sensitive subject 

The RIoT Brick is a Raspberry Pi Zero-based 
sensing station housed in a crudely 3D-printed 
box. Alan cheerfully explains that he prefers to 


The RIOT Brick is encased in 
a 3D-printed shell to protect 
the Raspberry Pi Zero inside 
tol K=MONVi=) mi dalomototagali(comaesl it 


Wi al- mO1Dor-l a of- Mb l-\-1o Koll o)ge)V(e(-Re] as) 

foto eo) col |at=ik=\-¥m ol ULM = IoM-)\.//1Ke1 a[=10 Re) mi Ke) 
fela=ss\>)aVi-m eye lak=)aVm ole)/{-1 me (Ul alave mual=mKe) 
Peaks Challenge. Those following Alan's 
progress via the web still got detailed data! 











RIOT BRICK | Project Showcase 
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> The RIoT Brick 
project cost less 
than £50 all-in 


Remote tracker 
data exchange 
was a particular 
challenge 


Vv 


Vv 


There was no way 
to check whether 
the transceiver 
was faulty 


It didn't matter 
because before the 
race began... 


Vv 


the aerial broke off 
in Alan's car boot 


Vv 


<The rig securely 
attached to Alan's 
ultra-running 
backpack 
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ES) \%Project Showcase | RIOT BRICK 


Create a RIoT 


The RIoT Brick consists of a Raspberry Pi Zero, 
battery pack, transceiver and sensor modules, 
plus related AWS scripts. Three Python scripts 
manage incoming data and check for an active 
internet connection. 






01 Connect your Raspberry Pi Zero to an 
nRF24L01+ transceiver. This will receive the 

data from the other sensors. You also need a u-blox 

NEO-6 GPS receiver to obtain GPS readings. 









Temperature, pressure, humidity, and light 
readings are provided by BME280 and 


02 


BH1750 sensors. Data from all the sensors and 
transceivers is stored locally in an SQLite database 
on Raspberry Pi Zero. 





03 This useful schematic shows the data flow 
and how to assemble the RIoT Brick. Full 
instructions are at magpi.cc/riot1Opeaks. 
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adapt existing code and hardware, and tries to 
stay well away from designing and printing ‘stuff’ 
for his projects. In this instance, the Brick case 
was needed to protect the Raspberry Pi Zero and 
sensing modules from many miles of jostling on 
his 58-mile run across ten peaks. 

The box houses a nRF24L01+ transceiver and 
u-blox NEO-6 GPS receiver, along with BME280 
temperature/pressure/humidity and BH1750 light 
sensors. Alan credits the Raspberry Pi and Linux 
community for the ease with which he was able 
to get these devices up and running. “I chose 
a Raspberry Pi Zero as the central component 
as I needed a flexible Linux platform that was 
sufficiently powerful to run multiple applications 
concurrently,” he says. 

The abundance of community-developed open- 
source libraries available for the modules and 
sensors he planned to connect to it was another 
big draw. He made use of an SQLite database and 
Python SDK Amazon Web Services. “IoT Core, 


RIOT BRICK | Project Showcae 
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<4 Data from four 
sensors in the RIoT 
Brick captured 
details of Alan's 
™ 10 Peaks race 
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M1 wads able to raise a few 
pounds for Alzheimer's 
Research UK as well @ 


IoT Events, DynamoDB, S3, Cognito, Simple 
Email Service, Lambda, and Elasticsearch Service 
are used to collect, process, and present this 
information back to my supposedly interested 
family members”, he explains. 


Bricks and pieces 

“During the event itself, there were several 
onlookers understandably baffled by the 
strange bright device attached to the side of 
my backpack,” says Alan. “A small number 
were even brave enough to ask! The reaction on 
Twitter has also been great, and I was able to 
raise a few pounds for Alzheimer’s Research UK 
as well.” 
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HAL 9000 — 
Google Assistant 








Zach Hipps 


Electrical engineer 
Zach Is happiest 
when he's inventing 
something and 
says he ‘loves to 
inspire others to 
make things they're 
excited about" 


magpi.cc/bytesized 


“| don't think | can do 
that" - creating HAL'’s 
case was far from 
straightforward and 
involved rethinking 
the internal setup 


A classic sci-fi film was the inspiration for this amazing Raspberry 
Pi-enabled voice assistant project. Rosie Hattersley is impressed 


assimilated into our everyday lives, with 

the concept of asking Alexa understood 
even by those who don’t make regular use of 
tech. Self-confessed tinkerer Zach Hipps wasn’t 
content with a standard-issue voice assistant, 
however. Instead he chose to give his smart 
speaker an iconic sci-fi film makeover and the 
sinister voice of HAL 9000. It’s based around the 
Google Assistant which, he reasoned, already ran 
on Raspberry Pi and there was likely to be plenty 
of documentation about it. Having a USB port was 
another point in Raspberry Pi’s favour. 


G mart speakers have quickly become 


Bits and pieces 
One of the most surprising aspects of the HAL 
9000 project is how inexpensive it was to build. “I 
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bought a USB microphone, LED, resistor, push- 
button, and plastic cupcake containers from eBay,” 
reveals Zach. “The remainder of the parts were 
designed in Fusion 360 and 3D-printed using my 
Artillery Sidewinder X1 3D printer.” Aside from the 
3D printing costs, and the Raspberry Pi 3 (which he 
already had), the project cost about S10. 

Zach used the Adafruit Retrogame utility to 
reprogram a GPIO pin to emulate a keyboard 
button press. The button, enclosed by the plastic 
dome from a cupcake, looks impressively like the 
film version. You press this to ask HAL a question 
from a list Zach created for the project (see ‘Hello 
HAL’ box, overleaf). 

“The only piece of code I had to write was a 
quick Bash script that sources the Python virtual 
environment and runs the Google Assistant 
software every time Raspberry Pi boots”’, he says. 


Mm Aside from the 3D printing 
costs, and the Raspberry 
P| 8, the project cost 
about $10 @ 


Perfecting the design 

The most time-consuming part of the project was 
creating and fine-tuning the enclosure for the 
HAL 9000 Google Assistant so it looked just like 
the one in the classic film, 2001: A Space Odyssey. 
“T imported a photo into Fusion 360 and created a 
basic sketch. From there I extruded features and 
added a place for the plastic dome,” says Zach. 


HAL 9000 GOOGLE ASSISTANT 





Ve-Xoi ae) giaix-ve @ual=mer-I-m amaale lad) elt 
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Connected to a GPIO pin 
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beneath a plastic cupcake cover 


rth Vie 


“| can see you're really 
upset about this.” It's quite 
strange being greeted by 
HAL's measured tones 





> Zach grew up 
building things in 
the garage with 
his dad 


He switched 
to an electrical 
engineering 
degree... 


Vv 


Soon after 
discovering 
Raspberry Pi. 
Coincidence? 
Hmm... 


Vv 


He's an ardent fan 
of our favourite 
single-board 
computer 


Vv 
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Vv 


He's currently 
working ona 
New England 
covered bridge 
A Zach spent hours getting the plastic dome to work as a push-button to activate his HAL 9000 Google Assistant mailbox notifier 
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Hello HAL 







= cy 


my HAL SOOO” 
}Google Assistant 


aoe ee vir oer rls ew 





A Designing the case in 
Fusion 360, ready for 
3D printing 


01 To create your own HAL Google Assistant, 

set the USB microphone and speakers as 
default playback and capture devices (you'll need 
device IDs for each). See Zach's hardware setup 
at magpi.cc/halgoooga. 






Wieloone to Actions on Google 


cei itm Ais ee fh Mae Mpa ru PS fod Al, la ed i ary Ny Diy HD i he ies 
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You don't have ary prosects yet. Click below tn get started 


02 Install Google Assistant API on your Raspberry 

Pi. Create a project in the Google API console 
(magpi.cc/googleactions) and create a Python 
virtual environment script to run the project. Add a 
command to make it run on bootup. 





03 Specify a GPIO pin on Raspberry Pi as 

your ‘push-to-talk’ button using Adafruit’s 
Retrogame utility (magpi.cc/retrogame). Set pressing 
ENTER as the mechanism to activate the talk function. 


Record a sample question to check it works. 
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Getting the cupcake dome to work as the push- 
button was far from plain sailing. After several 
test prints and iterations, Zach realised the whole 
thing was simply too large to print as a single 
piece: “It was about 34 inch too big to fit on the 
bed of my 3D printer, so I had to scale it down.” 
However, the enclosure still had to fit several 
existing components. To make it work, he ended up 
reversing the position of several items. Raspberry 
Pi ended up at the top, which then meant the 
speaker and USB microphone connected to it also 
needed to be repositioned. 

“T had to tweak dimensions until everything 
fitted correctly,” recalls Zach. “A powerful 
feature of Fusion 360 is that you can design 
parts parametrically, which means if a test print 
didn’t fit, I could go back and change one or two 
parameters and the whole design would update.” 


M|f atest print didn't fit, | could go back and 
change one or two parameters and the 
whole design would update @ 


Once all the pieces had been 3D-printed — a 
process taking 30 to 40 hours — assembly could 
begin. Zach positioned the microswitch in its 
enclosure and installed the 10mm red LED with 
its resistor and the clear dome into the mount. He 
then connected up all the wires to Raspberry Pi. 
Finally, he put together the all-important casing 
that makes Zach’s HAL 9000 such a showstopper. 

“T designed the enclosure to be in several pieces 
so that I could print them in different colours, 
rather than having to paint the different colours 
onto one monolithic print. I glued all these pieces 
together before putting on the back panel and 
securing it with screws,” he tells us. 

“At this point”, he says, modestly, “the 
HAL 9000 Google Assistant using a Raspberry Pi 
was complete!” 


Project Showcase 








Creating a case that 
looks just like the 
original 1968 film 
version of HAL was 
a labour of love. 
Someone suggested 
it could also make a 
great photo booth 


The finished project. 
“lam completely 
operational and 

all my circuits are 
functioning perfectly,” 
reports HAL 
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Apollo Pi 


Fans of portable Raspberry Pi projects will love this thermal sensing camera 
disguised as dg 1970s microwave scanner, thinks Rosie Hattersley 


ere at The MagPi, we love a retro project 

and have previously featured several such 

builds by serial old-tech upcycler Martin 
Mander. What was to become the latest example 
— the 1979 Apollo Pi thermal sensing camera — 
started out as an Arduino project in which Martin 
and his colleagues at Norfolk County Council 








Martin challenged each other to design a way of counting 
Mander library visitor numbers. 

When the gauntlet was first laid down, Martin 
Martin works in decided it would be a good time to use an Adafruit 
the Intelligence = 
& Analytics 


———— 


department at sg 
Norfolk County an SERIAL NO. 
Council, where —> 

he's able to make 
good use of his 


love for Internet of 
Things builds. 


kyliemander.com 


> The original 
Apollo Monitor X| 
microwave scanner 
Martin adapted for 
his project 
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thermal sensor he’d already bought. “Our libraries 
already use commercial thermal visitor counters, 
so I thought I’d build my own,” he reasoned. Years 
of designing projects has taught him that it’s best 
not to get too hung up sticking with your original 
plans. Instead, he says, it’s best “to get started and 
see where the project takes you!” He advises: “it’s 
always good to do lots of research up front and have 
a clear idea of what you want to achieve, but some 
of the most rewarding projects are those where you 
make at least some of it up as you go along.” 
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Martin swears by 
the cheap digital 
Vernier calliper he 
got at Lidl. 





Apollo Pi displays a 
dal=)aaqts\@laats\e(=Melm-|ake)e)(-ce1 in 
cleverly detecting life 

forms. Here, the cat's fur is 
foi (== Ta NVA oxolo) (=) ale laminmelele hy 


It frequently 
informs him “that's 
not going to fit 

in there" 






ase TL 







» He intends to use 
Apollo Pi to check 
for chicks in the 
garden bird-boxes 


- His Raspberry Pi- 
based timer tells 
him when to take 
a break 





Look out for his next 
project on Twitter: 
@OldTechNewSpec 


Pressing the trigger button 
on the rear tells Raspberry 
Pi to start sensing the heat 
of what's in front of it 
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/ Fever ar chi 


Fever or Chill 


MMifomum (er on Soren} 


Latest Sep hes 


> Testing the thermal 
sensor and the . Explore “A delayed game is 
display settings for 
the temperature 
readings 


eventually good, a 
bad game is bad 





forever” - 

WV Martin adapted T 
Adafruit’s Python 
code for the 


Ovic 


thermal sensor. He 
chose Raspberry 
Pi because SciPy 
could use bicubic 
interpolation to 
vastly improve 

the display 





Martin expected it to be a quick build. “I thought 
I'd pop the components into an old infrared flash 
eun in an afternoon,” he recalls. Unfortunately, 
the case was too small, so he had to rethink. 
Digging around in his dusty boxes of old tech for an 
alternative, the Apollo monitor caught Martin’s eye. 


















New 


CaTLpy * 


. “Tt really leapt out at me as it was just the right size, 
esi icheite and also a perfect ‘hold and point’ shape. It was 
MATER vee 22, easy to imagine it as a thermal camera.” 
COLORDEPTH = 19: Change of plan 
aes te Parts for the project were sourced online, costing 
I around £70 in all. The biggest expense was the 
Shel thermal sensor. After connecting the screen, 
sensor, and Raspberry Pi Zero W, Martin started 
es working out what extra switches he’d need, plus 
| PUMA 2.058 swiGiiey, Needed Anu tiluand Ovaveaneeiaiiee’s how to power the device. He was able to make 
PHL IPS “oe 1 use of small bits of leftover plastic as circuit 
. , = board covers, and spent a long time trimming the 
LS, TERRES Th Thonny - shomeypir_ |Fipygame window BS COCéoriginal case to make the new components fit. 
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A Martin chose Apollo 
Pi's colours to be 
redolent of the 
1970s, and bought 
the paint just as DIY 
shops closed down 
this spring 


The screen and sensor are connected to the 
GPIO pins via jumper cables. To prevent them 
disconnecting while cramming everything into the 
erip, Martin hot-glued them in place. With a USB 
battery pack fitted, he was ready to start testing. 


Altering the script 

Software for the project (magpi.cc/apollopi) 

is based on Adafruit’s Python code for the 
thermal sensor. “All I’ve done is added in some 
extra code to handle more button presses, and 
some additional integrations with Adafruit.io, 
to enable uploading the captured images and 
using dashboard sliders to set the temperature 
threshold,” explains Martin, modestly. 


M | thought I'd pop the 
components into an old 
Infrared flash gun In 

gn afternoon @ 


Apollo Pi took him a month to build, devoting 
an hour each evening to the project. “I enjoyed 
taking my time with it and not rushing to finish,” 
he says. As he doesn’t have a 3D printer, he had 
to make everything himself. “A 3D printer would 
make a much neater job of such tiny parts, but it 
was incredibly satisfying whittling and filing them 
by hand!” 
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Attach the thermal sensor and LCD screen 
to Raspberry Pi Zero W using jumper cables 
rather than directly mounting on the GPIO pins. 


Add a slim USB battery pack and connect it to 
Raspberry Pi Zero W via a cable with a latching 
button to turn it on/off. Assemble your customised 
hand-held scanner so any circuitry is hidden, but 
leave space inside the case so the trigger can be 
depressed when you want to scan an object. 





03 Save instruction code to an FTP site, then use 

PuTTY and Filezilla to instruct Raspberry Pi to 
power on the display. Sensor info and code can be 
found at magpi.cc/apollopi. 
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Raspberry Pi processes live hive data 
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Keeping an eye on bee life cycles is d brillant example of how Raspberry Pi 
sensors help us understand the world around us, says Rosie Hattersley 


etting to design and build things fora access to several hives at his keen apiarist parents’ 

living sounds like a dream job, especially if = garden in Snowdonia, Glyn set up BeeMonitor 

it also involves Raspberry Pi and wildlife. using some of the tools he used at work to track the 
Glyn Hudson has always enjoyed making things beehives’ inhabitants. 
and set up acompany manufacturing open-source “The aim of the project was to put together a 
energy monitoring tools (openenergymonitor.org) | system to monitor the health of a bee colony by 
shortly after graduating from university. With monitoring the temperature and humidity inside 





and outside the hive over multiple years,” explains 
Glyn. “Bees need all the help and love they can get 
at the moment and without them pollinating our 
plants, we’d struggle to grow crops. They maintain 
a 34°C core brood temperature (+ 0.5°C) even when 
the ambient temperature drops below freezing. 
Maintaining this temperature when a brood is 
present is a key indicator of colony health.” 


Glyn Hudson 


Having studied 
electronic engineering 
at university, 

Glyn co-founded 
openenergymonitor.org, 
designing and building 
open-source energy 
monitoring tools to help 
people understand 
energy and optimise 
energy consumption 
and generation. 


WiFi not spot 

BeeMonitor has been tracking the hives’ 
population since 2012 and is one of the earliest 

, examples of a Raspberry Pi project. Glyn built most 
Glyn checking the original BeeMonitor setup of the parts for BeeMonitor himself. Open-source 
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A BeeMonitor complete with solar panel to power it. The 
Snowdonia bees produce 12 to 15 kg of honey per year 


software developed for the OpenEnergyMonitor 
project (emoncms.org) provides a data-logging 
and graphing platform (magpi.cc/emoncms) that 
can be viewed online. 

The hives were too far from the house for WiFi 
to reach, so Glyn used a low-power RF sensor 
connected to an Arduino which was placed inside 
the hive to take readings. These were received by a 
Raspberry Pi connected to the internet. 

At first, there was both a DS18B20 temperature 
sensor and a DHT22 humidity sensor inside the 
beehive, along with the Arduino (setup info at 
magpi.cc/dsi8b20sensing). Data from these was 
saved to an SD card, the obvious drawback being 
that this didn’t display real-time data readings. 

In his initial setup, Glyn also had to extract and 
analyse the CSV data himself. “This was very time- 
consuming but did result in some interesting data 
[magpi.cc/beemonitorvi],” he says. 


M Bees need all the help 
and love they can get at 
the moment @ 


Sensor-y overload 
Almost as soon as BeeMonitor was running 
successfully, Glyn realised he wanted to make the 
data live on the internet. This would enable him 
to view live beehive data from anywhere and also 
allow other people to engage in the data. 

“This is when Raspberry Pi came into its own,” 
he says. He also decided to drop the DHT22 
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humidity sensor. “It used a lot of power and the 
bees didn’t like it - they kept covering the sensor 
in wax! Oddly, the bees don’t seem to mind the 
DS218B20 temperature sensor, presumably since 
it’s around metal object compared to the plastic 
erille of the DHT22,” notes Glyn. 

The system has been running for eight years 
with minimal intervention and is powered by an 
old car battery and a small solar PV panel. Running 
costs are negligible: “Raspberry Pi is perfect for 
getting projects like this up and running quickly 
and reliably using very little power,” says Glyn. 

He chose it because of the community behind the 
hardware. “That was one of Raspberry Pi’s greatest 
assets and what attracted me to the platform, as 
well as the competitive price point!” The whole 
setup cost him about £50. 

Glyn tells us we could set up a basic monitor 
using Raspberry Pi, a DS28B20 temperature sensor, 
a battery pack, and a solar panel. H 


Monitoring set-up on National crown board 


Humility berlow concen 


Temperniura, below cron 


AuUMmty aoe Cece Pa 


ae a 
Tamperaiure above own +2 
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Core lemperabure 


| 


To LOD splay 24 
12 bakery 
Connections 


> Apis is the Latin 
word for bee 





> Glyn’s parents 
are keen amateur 
apiarists 


> He'd like to adda 
hive weight monitor 


> This would reveal 
how much honey 
the hive produces 


> Glyn documents his 
project at magpi.cc/ 
beemonitorgit 


Unlike the 
humidity sensor, 
the bees don't 
seem to mind the 
temperature probe 





Diagram showing 
what information 
BeeMonitor is 
trying to establish 
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Giant Battleships 


Play a classic game of Battleships on a giant LED matrix 
using an antique phone to give orders, Phil King dials in 





Dan Aldred 





Raspberry Pi 
enthusiast, NCCE 
facilitator, teacher, 
and coder who 
enjoys creating new 
projects and hacks 
to inspire others to 
start learning. 


tecoed.co.uk 


» The giant LED 
matrix comprises 
a 10x10 grid of 
NeoPixels, their 
light diffused by jars 


the Battleships strategy game sees each 

player positioning a fleet of ships of 
varying lengths on a grid. They then fire shots 
in turn, by issuing co-ordinates, to try to hit the 
opponent’s hidden ships and sink them. A board 
game version featuring plastic pegs for shots 
was launched in 1967, later followed by snazzy 
electronic and talking versions. 

Dan Aldred has now taken the concept one 
stage further by recreating the classic game ona 
giant colour LED matrix, with the player issuing 
shot co-ordinates using the rotary dial of an old 
telephone: magpi.cc/battleships. 

“After creating my giant 10x10 LED board — which 
is great for light shows, lockdown discos, and 
general colour displays (magpi.cc/ledboard) — I 
wanted to create a giant game,” he reveals. As he 
had previously coded his own version of Battleships 
for the Sense HAT, it seemed a natural choice. 

In this version, the game is played solo witha 
limited number of torpedoes to try to sink all the 


0 riginally played with a pencil and paper, 
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» The LED matrix doubles as an impressive disco light show. Dan 
is considering using it for Conway's Game of Life 


randomly placed ships. After a short introduction, 
the player is asked to select their first co-ordinate. 
“You simply dial a number and this is then sent 
as data to the LED board’s Raspberry Pi, which 
triggers another prompt telling the player to 

dial the second number,” explains Dan. “Once 
the co-ordinates have been dialled in, the board 
tracks the locations, flashes, and then calculates 
if the torpedo has hit a boat. If it was successful 
then a message is sent back to the telephone 
which triggers a random response consisting 

of an explosion (sound) and a voice update. If 

the torpedo misses, different data is sent to the 
telephone which triggers the miss response, the 
sound of empty water.” 


Double helping of Raspberry Pi 
While Dan originally intended to use a single 
Raspberry Pi for the project, he ended up using two 
of them — one inside the LED matrix and another 
in the telephone — to avoid the matrix’s NeoPixels 
interfering with the audio for the sound effects and 
speech, which is played through the telephone’s 
original handset speaker. “The simple solution 
was to use a second Raspberry Pi which would be 
situated away from the LED [matrix].” 

Two-way communication between the project’s 
two Raspberry Pi boards is achieved using sockets 
controlled by Python, although Dan encountered 
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The giant LED matrix comprises 
a 10x10 grid of NeoPixels, their 
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Red cross-hairs show where 

: the shot is targeted - a hit 
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> The LED matrix 


took around six 
months to create 





> Its NeoPixels are 
diffused by glass 
jars painted white 


some problems. “I did manage to establish one- 
way communication between the telephone and 
the LED board fairly early on in the project but 
could not get the board to communicate back to the 
telephone, which meant that I could not trigger the 


> The Battleships 
game took a month 


gameplay sounds and updates. Big thanks to Nicole to develop 
Parrot who showed me that I was using redundant 

code and sent me an example of the new code and > The phone 
from then on it was plain sailing!” was bought 


in an antiques 
clearance sale 


M You simply dial gd number 
and the data Is sent to the 
LED board's Raspberry Pi 


Reading the dial 

The method for how the Raspberry Pi reads the 
numbers from the phone’s rotary dial is simple, 
according to Dan. “Basically, you send a small 


> Its speaker is wired 
directly to test pads 
on Raspberry Pi 


A While Dan had used an old GPO phone previously for his Pi Phone 


current from a GPIO pin through the rotary project, the mechanism in this Swiss one was completely different 
dial and back to aGND pin on Raspberry Pi. 
When you dial a number, the circuit is broken listening devices and phone tapping equipment. 
or interrupted (often referred to as clicks). So if “This is where I got excited that perhaps my Swiss 
you dial a number one, you get one click, or one telephone had sat on the desk of an important 
interruption; if you dial the number seven, you get person and been tapped!” says Dan. 
seven clicks or interruptions.” While a thorough inspection of all the parts 
Bought for just £5, the 1960s Bakelite phone had "of the phone sadly revealed no bugging device, 
plenty of room for housing a Raspberry Pi. Dan “There is something quite fun about hearing the 
discovered it was made by Swiss manufacturer instructions and game sounds coming through an 
Zellwegger, which used to make government old telephone handset.” Hl 
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‘Greenhouse’ 


Upcycling an old coffee machine into a 
plant-watering gardening assistant sounds 
like g latte fun. Nicola King filters the facts 


hen his wife’s ten-year old coffee maker 

decided to stop working, Jeremy Cook - a 

maker who likes to upcycle items - saw 
an opportunity. He felt that the Keurig machine 
could still have some use, and so he percolated some 
ideas for its future incarnation. “I couldn’t quite 
bear to part with such a cool piece of technology,” 
he explains. “The Keurig has a water tank and 





Jeremy a means of dispensing water, so it seemed only 
Cook : 

natural to have it water plants. 
A US-based 


A beans to an end 

Having eventually figured out how to disassemble 
the original machine, Jeremy then turned his 
attentions to using its features in a new way. 
“There’s an air pump that, when activated, causes 
water (or presumably coffee) to go out the spout,” 
he says. “It seems that it pressurises the liquid 
chamber and forces water out this way... As for 
my setup, the Raspberry Pi activates this air pump 
at acertain time. The brew button is a manual 


Controlled by Raspberry 
Pi via a transistor, 5V is 
re} e) eli (=1e Kom dal-m-lla olelaale) 
1 Kol ofe)\ (=) ma Wal=maal=\erallals) 


maker who enjoys 
tinkering, upcycling, 
and giving items a 
new lease of life. 





admits that there were a few challenges along the 
way, including figuring out the button and light 
circuitry from only the wires: “I didn’t disassemble 
enough to actually see where they were going.” 
He also admits that it does still require some 
fine-tuning, but he’s generally pretty happy with 
his new gardening aid. “I left the outer cover off 
as I think the internals look cool,” he adds, “but 
I hid all the extra parts in the original electronics 
cavity inside, so it does look mostly original, if 
partially disassembled.” 


The Keurig has a water tank and a means 
of dispensing water, so It seemed only 
natural to have it water plants 


trigger for watering. A soil moisture sensor tells the 
system when it’s thirsty (though doesn’t control it 
directly) - when dry, a red light built into the Keurig 
(and repurposed) lights up. A blue repurposed light 


One person's rubbish... 
Jeremy is not done tinkering just yet. “There’s an 
unused but hooked-up power button that I may do 


signifies that it’s watering.” 
Ingenious, and such a great way to redeploy 
something destined for the scrap-heap, but Jeremy 
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some sort of lighting test with,” he says. “I suppose 
it is an automatic watering system, but I’ve had the 
thought that I could put a tube on it and water larger 
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plants. Again, more of a thought, but you could get 
like ten of these for a giant watering system. In this 
case, solar power would be good, but would kind of 
mess up the looks.” 

Jeremy chose to use a Raspberry Pi Zero W 
because it was the perfect size to fit inside the 
Keurig’s electronics compartment, along with 
a mini breadboard. He has used Raspberry Pi 
computers before, including running his 3D printer 
via OctoPrint. “I also have a DIY NAS setup that runs 
on. a Raspberry Pi 4,” he adds. 

Online feedback on the watering machine has 
been positive, says Jeremy. “People seemed to think 
it was a neat idea when I told them about it before it 
was quite finished, or at least on the internet. I’ve 
gotten good feedback from YouTube etc.” 

Inspired yet? It just shows what you can do with a 
little imagination... and a Raspberry Pi, of course! 


Project Showcase 


A moisture sensor sends 
data to Raspberry Pi: if 

it's too dry, the machine's 
Sico\w/molelace/am (om limelomlala-re 
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This project 
took Jeremy 
20-30 hours, over 
a period of around 
two months 


He wrote an article 
on the build for 
arrow.com: 
magpi.cc/ 
coffeegreenhouse 


A 3D-printed part 
houses a Raspberry 
Pi Zero W inside 
the machine 


He also grows 
pineapples in 
pots made from 
disposable juice 
containers 


His future project 
plans include 

a portable 
oscilloscope 


The exposed rear 
of the machine, 
showing the various 
wires and tubes - 
it's less complicated 
than It looks 
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Piano-Playing Robot 


This robot can play scales, chords, arpeggios, or totally new musical scores. Phil King listens in 





Etienne 
Allaire 


Etienne is a fourth 
year undergraduate 
student in Electrical 
Engineering at 
Polytechnique 
Montreal and plans 
to pursue a master’s 
degree in Artificial 
Intelligence. 


magpi.cc/ 
pianorobot 


Etienne Allaire felt a little regretful. “I 

realised that we played very rarely and 
found it a pity that such a beautiful instrument 
remained unused for so long!” he recalls. “That is 
when I had the idea of a robot that could play all by 
itself to add to the ambience of the home. It is also 
a combination of several fields that I love: music, 
engineering, and artificial intelligence.” 

It took him around four months, on and off, to 
develop his Piano-Playing Robot. As shown in his 
YouTube project video (magpi.cc/pianorobot), it 
features 15 solenoids mounted on a wooden frame 
placed on top of an electronic piano keyboard. 

“Basically, the system is quite simple,” reveals 
Etienne. “Each solenoid pushes on a piano key and 
is controlled by a specific GPIO pin of a Raspberry 
Pi 3 Model B.” Since the latter doesn’t have enough 
electrical power to activate the solenoids directly, 
an electromechanical relay module acts as a buffer 
between the two.” 


ooking at the piano in his living room, 


MA camerd was added to redgd dnd decode 
new musical scores that had never been 
Shown to the robot before @ 


> Some of the 


solenoids are 
positioned over black 
notes, enabling the 
robot to play sharps 
and flats in various 
scales and melodies 


Fast ‘fingers’ 

The system can read a MIDI file, convert it into 
on and off signals for each note, and play it. A 
basic UI allows the user to choose between scales, 
arpeggios, or melodies. 
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> Mounted ona wooden frame, the 
solenoids respond quickly and can be 
triggered simultaneously to play chords 





“As of now, the robot can play a full scale in 
just under two seconds,” reveals Etienne. “That 
is, at the fastest rate, it plays about eight keys per 
second.” This impressive speed makes it possible 
to get the timing of the notes just right. 

“However, the system is limited by the push and 
pull times of the solenoids, which add up to a few 
tens of milliseconds,” he adds. “At a first glance, it 
may not seem like much, but in a fast melody it can 
make a difference. Our robot still has a long way to 
go to overtake human-beings: the fastest pianist 
in the world claims to be able to reach up to almost 
20 keys per second!” 


Sight reading 

So far, he has programmed the robot to play six 
scales, six arpeggios, and five different melodies. 
The most impressive feature, however, is its ability 
to read previously unseen sheet music — using a 
Raspberry Pi Camera Module — and play it. 

“A camera was added to the system to read and 
decode new musical scores that had never been 
shown to the robot before,” says Etienne. “It then 
scans, decodes, and plays them.” 

To do this, it uses a free open-source tool called 
Audiveris. “It is a complex program for optical 
music recognition (OMR), which is recognition 
of musical symbols. Unlike optical character 
recognition (OCR), this task requires decoding the 
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I ColUTalxsve Molar e)Kolel aoa 
wood, a Raspberry Pi 
Camera Module reads 
sheet music, which is 
analysed using OMR 


When activated, each 
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to be sent to them 
> This is Etienne’s first 


serious project with 
a Raspberry Pi 





The robot took 
around four months 
to develop 


Vv 


configuration of symbols in two dimensions. In 
addition, the order of magnitude of the symbols is 
extremely wide (sometimes ranging from tiny dots 
above musical notes to symbols that are drawn 
across a large part of the page).” 

In brief, the recognition process is done 
with classifiers and neural networks that make 
matches with symbols previously learned. “For 
my project, the decoding part was done on a laptop 
since Audiveris was more easily compatible with 
Windows,” he explains. “On average, it takes 
around 30 seconds for the robot to decode a sheet 
of music containing a few staves.” 

Etienne is hoping to add extra features to the 
robot. “In particular, I would like to extend the 
concept to 88 solenoids. This way, the robot 
would theoretically be able to play all the existing 
melodies on the piano! Obviously, there is a lot 
of development to do in terms of Optical Music 
Recognition, but I like to imagine a piano concert 


He burned a few 
transistors at 

the start of his 
experiments 


Vv 


When activated 
simultaneously, 
the solenoids 
require a lot of 
electrical current. 


Vv 


At first, he had 
trouble supplying 
them with 
enough power 


Vv 





} A ARaspberry Pi Camera Module is used to read sheet music, its 
performed entirely by a robot!” Hl images being analysed using optical musical recognition 
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Singing Toilet 


A trip to the washroom need no longer be boring - meet the 
Singing Toilet! Nicola King seeks out the heavenly harmonies 








Max 
Bjorverud 


A sound and 
code artist based 
in Stockholm, 
Sweden, Max's work 
involves musical 
instruments, 
museum 
exhibits, public 
art, interactive 
installations, 

and more. 


bjorverud.com 








t may be the ultimate bathroom experience: 

wall-mounted toilet rolls that ‘sing’ various 

notes when the paper is pulled, thus creating 
an extremely pleasant and calming trip to the 
smallest room. But how did this very novel idea 
come to fruition? 

Maker and artist Max Bjorverud explains that 
this custom installation was born from a request 
from a client: “Fredrik Ost at Snask (a creative 
agency) here in Stockholm wanted something for 
the toilet. I don’t remember how our conversation 
really panned out, but a week later I presented the 
first prototype. The build itself was quite quick, but 
it needed some iterations to find the best holder 
and roller. The most difficult part was to make it 
usable. They need to be able to switch toilet paper 
without a technician.” 


You gotta roll with it 

The system is built around a Raspberry Pi, a 
HiFiBerry AMP to output high-quality sound to 
a hidden speaker, and an Arduino Mega to take 
readings from eight Hall effect sensors. In each 
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A A 3D-printed part on the end of 
each roll holder contains a circular 
magnet that triggers a Hall effect 
sensor on the left when rotated 
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A Raspberry Pi, HiFiBerry AMP, and 
speaker are placed in a wooden 

box, along with an Arduino Mega 
connected to the sensors . 


toilet roll holder, a 3D-printed part contains a 
circular four-pole magnet that triggers the Hall 
effect sensor when rotated. Whenever it receives 
data from the sensors via the Arduino, Raspberry 
Pi outputs the respective sound sample for each 
moving toilet roll. 

“As long as a roll is rolling, the Arduino will send 
a continuous message telling the Pure Data patch 
to play that specific sample,” says Max. “It’s built 
in such a way so that the voice will sing as long as 
the roll is rolling.” 

A few technical issues were encountered in 
the build process, including random instances 
of failure to work: “My audio patch (program) 
consumed 100% CPU and clogged the whole 
Raspberry Pi,” recalls Max. “That version used 
windowing functions to create seamless pitch 
shifting of the samples I used for audio playback. 
Had to abandon that...” 

Max also had to fiddle with the Hall effect 
sensors for quite a while before he was happy with 
their placement, and a colleague assisted with the 
3D prints, but all their efforts proved worthwhile. 











Raspberry Pi and the sound speaker 
FeV com Colors | K-10 Mi lalsy(e(=m-Mufeleye(=18) 


enclosure, “painted pink just like 
everything else so you won't see it” 


| 


M |t's Built in such gd way so that the voice 
will sing as long as the roll is rolling @ 








A Prototyping the 3D-printed magnet-holding 
parts that fit onto each toilet roll holder 
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> The project took 
around six months 
to develop 


é > Watch the project 
in action: magpi.cc/ 
singingtoilet 


> Max has created 
other installations 
for Snask... 





> .A window that 
compliments you, 
and a modified 
doorbell 


> Read more on 
Max's work here: 
bjorverud.com 


When it comes to changing the rolls, this is just 
done normally and the only thing that people need 
to remember is to put the roll back in the correct 
direction: “The magnets inside the 3D print must 
face the Hall effect sensor on the left.” 


Flushed with success 
While Max has had great feedback on his creation, 
“there hasn’t been much interaction since people 
are out of office nowadays. I’m currently learning 
how to play it sol can hold toilet concerts.” 
Integral to the Singing Toilet, and to all his work, 
has been Raspberry Pi. “[{It’s] my go-to tool for 
interactive audio, mainly because I’m so used to it, 
but also because there’s such a great community 
where any help needed is out there to be found,” 
Max tells us. “My past projects with Raspberry 
Pi include a huge dance carpet, a synth made of 
steel, museum exhibits, and various interactive 
audio projects.” Wl 
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A museum celebrating the diversity of London's residents comes to life 
when visitors linger near its artefacts. Rosie Hattersley discovers more 





Chris Owens 





Chris Owens is one 
of the founders of 
Clay Interactive, 

a company 

that specialises 

in creating 
interactive exhibits 
for Museums. 


clayinteractive.co.uk 


few weeks before spring 2020’s UK 

lockdown, there was a buzz of excitement 

among visitors to Lewisham Shopping 
Centre in south-east London. Slabs from the 
Berlin Wall emblazoned with brand-new street 
art greeted visitors at the entrance to the former 
H&M store, while the storefront display is one of 
assorted luggage with tags from around the world 
and many generations. 

Thoughtfully curated bookshelves in the gift 
shop contain tales and memoirs from Windrush 
Generation writers and set the tone for the rest of 
the exhibition. The reconfigured former retail unit 
now contains TV set-like areas with a classroom, 
kitchen, bedroom, and a hairdresser’s shop. 
Peeking in the bedside drawer or rummaging 
among the clutter on the mantelpiece, the 
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curious visitor finds postcards, paintings, maps, 
and photos revealing the lives of those who 
made London their home. Taking a seat in the 
hairdresser’s, you’re invited to don headphones 
and listen to the stories recounted by the figure 
who appears in the mirrored screen. Gazing at 
the dressed dining table prompts a light to beam 
images onto the bare dinner plates, with recipes 
and muttered memoirs of favourite dishes. 


Visual storytelling 

The Room To Breathe interactive displays are the 
handiwork of Chris Owens and his colleagues from 
Clay Interactive. Commissioned by Aditi Anand, 
The Migration Museum’s head of creative content, 
they created interactive sets created from artefacts 
that help tell immigrants’ tales. 





> Chris and his team 
have projection- 
mapped food before... 





> ..for an exhibition at 
The British Library 


> Their data 
mirror guessed 
Science Museum 
visitors’ ages 


> But they'd never 
used Raspberry Pi 
fora museum 
project before 


> They're now helping 
The Migration 
Museum add more 
RFID features 


M™ The technology had to 
work unattended all day, 
every day @ 


“Our role was to try and make the various rooms 
in the exhibition as interactive and engaging as 
possible within their very tight budget,” explains 
Chris. “We knew we needed to have perfect full 
HD playback and the technology had to work 
unattended all day, every day, so reliability was 
also key.” 

Chris says he needed a ‘makers’ mindset’ as 
off-the-shelf hardware setups typically used by 
museums were simply too expensive. “Having used 
Raspberry Pi for a home automation project, I knew 
a bit about the platform and saw the benefits of 
the built-in GPIO combined with a compact low- 
power platform that could support pretty much any 
programming language.” 
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MIGRATION MUSEUM | Project Showcae © 
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A Framed pictures 
in the living room 
become videos of 
people sharing 
their memories 


40 Adish for making 
byrek, a traditional 
Albanian filled pastry 
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Interactive display details 
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A PIR sensor is used to trigger an object to 3 
respond to someone's presence. 


01 





A Interactive rooms, 
such as the Golden 
Scissors barber's, 
bring personal stories 
from new arrivals 
to Britain to life in 
unexpected ways 


They created the digital signage themselves 
using hardware from The Pi Hut, as well as 
Amazon. “It was really easy for us to get a 
prototype of the hardware up and running as the 
GPIO pins on Raspberry Pi make it easy to connect 
up and test switches and sensors,” says Chris. 


The broader picture 

“The PIR (passive infrared sensor) has a very wide 
viewing angle as it’s designed to look at a whole 
room,” says Chris. “We wanted only small areas 
to trigger the media, such as sitting on a chair 








02 The PIR is enclosed in a tube to limit its sensor 
range, meaning it only triggers when someone 


Like the other items, 
this case bears a 
label telling the story 
of how its owner 
came to Britain 





or standing very close to something.” To reduce 
the PIR’s field of view, they simply put it inside a 
tube so it could only ‘see’ what they wanted it to 
see. Occasionally, the PIR would be triggered by 





is close by. 
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0 Discreetly placed Raspberry Pi-controlled 
switches trigger the audio when the 
headphones are picked up. 
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WiFi activity, but they fixed this by switching off 
the wireless LAN adapter on Raspberry Pi since it 
wasn’t used for this project. 


The team used switches to trigger audio playback 


when visitors picked up headphones. Other 
switches were added to restart an audio or video 
feed, or to shut down Raspberry Pi. 


M™ The software Is mainly just 
keeping track of whether 
someone Is still present 


Achieving smooth 1920x1080 video playback 
was one of the trickier elements. Chris and 
his colleagues decided to use omxplayer 
(magpi.cc/omxplayer) because it can fade in and 
out. This was controlled using the omxplayer- 
controll package (magpi.cc/omxcontroll). 

The main program was written in Node.js as 
that’s where their programmer’s expertise lay, 
and also because it offered several useful libraries. 
Clay’s expertise is in creating exhibits with 
projection mapping, presence detection — ideal for 
the PIR motion sensors — and two-way mirrors. 

“After being triggered and starting to play 
media, the software is mainly just keeping track 
of whether someone is still present,” says Chris. 


MIGRATION MUSEUM | Project Showcae 


<4 The Migration 
Museum, housed in 
Lewisham Shopping 
Centre, features 
pieces of the 
Berlin Wall 





V Postcards, letters, 
and spoken stories 
tell children’s stories 
about coming to live 
in the UK 


Once there’s nobody around, it will stop playing 
media. In the case of the barber’s, the mirror 
becomes a normal mirror again and, in the kitchen, 
the animated plates and tablecloth will return 

to normal. 

“Raspberry Pi is a really interesting platform 
for museum work as it’s small, flexible, and cost- 
effective. Its popularity also means it’s easy to 
get hold of. We are definitely thinking of it asa 
possible solution to all sorts of needs.” 

The Migration Museum is planning a phased 
reopening when safe to do so. For more details, 
visit migrationmuseum.org. {I 


The Official Raspberry Pi Handbook 2021 | 115 


MS) Project Showcase | PROJECT ZED 





Project Zed 


A sci-fi Inspired robot made from old printer parts is helping fight the good 
fight, just like the character that inspired it. Rosie Hattersley explains how 





Joseph Uding 





Joseph Uding's 
robot-building 
education started 
with Stan Winston's 
Hollywood 
animatronics and 
MIT's robotics 
online courses. He's 
now a project officer 
at Hive Colab's 
department of 
Robotics and Al. 


hivecolab.org 


> The robot can 
move around, 
telling people to 
put on their masks 
and to keep 
their distance 
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of Raspberry Pi when he was studying 

robotics with MIT online and was 
pondering the amount of computing power 
required for ASIMO, Honda’s famous humanoid 
robot. “The bigger the robot, the bigger the motors 
and batteries, plus many things that can go wrong 
because a robot is made up of many computers 
in it,” he reasons. “That’s when I started loving 
Raspberry Pi.” 

The single-board computer features prominently 
in Joseph’s Project Zed robot, created as a means 
of encouraging citizens to take sensible health 
precautions during the coronavirus pandemic. “A 
friend said ‘build a robot that can help in fighting 
Ebola in West Africa’. That was in 2016 and we 
didn’t take it seriously because no cases were in 
Uganda, but when 2020 came I got to work. Witha 
robot, he says, “you can carry out random tests and 
collect information from someone without risking 
important medical workers.” 

Raspberry Pi enabled Joseph to add personality 
and voice-based interaction to the robots he’s 
built, as well as delivering preset messages such as 
“don’t forget to wear a face mask”. 


oseph Uding first fell for the charms 


Parts and labour 

Project Zed is, by necessity, a masterclass in 
upcycling: 3D printers and next-day component 
deliveries aren’t reliably available in Uganda, but 
Joseph believes that if you can have a clear idea 
of what you want to make, you can make it from 
almost anything. “The first thing is to see the 
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Cats’ serious 
expressions are 
another influence 


His robots 
sometimes seem 
deep in serious chat 


He loves his 
Raspberry Pi 3B+ 
and says... 


“| can program it to 
do magic when it 
comes to robotics” 
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» Joseph's first ever robot, TIM, made from a TV antenna, with 
facial expressions by Google Assistant on an old mobile phone 


problem you want to solve with the robot you want 
to make.” His project took him just three weeks. 
After work one day, he went to visit some guys 
who fix printers and asked them for old dead ones. 
“They smiled and gave me about four spoiled old 
printers. From there I got DC motors and plastic 
parts to use when housing the robot.” The motors 
would be used to replace those in a broken RC 
car that would act as the robot’s base and help 
stabilise it. 


M|t can move its arms up 
and down, but not the 
fingers yet @ 


The initial designs were in lightweight wood he 
sourced himself — “just like the way planes are 
made” — which was light and easy to work with. 
Plastic from the old printers was used for the casing. 

Aside from the Raspberry Pi to control things, 
the half-humanoid, half-RC car robot has a 
Roboclaw 2 motor controller (magpi.cc/roboclaw) 
and a Google Coral AI USB accelerator 
(magpi.cc/coralusbaccelerator). 

It can be controlled from a distance of up to 





., 





ey Slee dcedibenlt roughly 400 metres and can listen, talk, and see 
a solar panel to objects. “It can move its arms up and down, but 
, —" ieee scene not the fingers yet,” says Joseph. “It’s limited to 
_— ZN - job in remote areas” doing one thing at once — bending down to pick 
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Cyber setup 


= 








Assemble parts including an RC motor 
01 3 | | 
and create a lightweight wooden or plastic 
frame. Start with parts for the head to the waist. Join 
together using glue and screws. 





ie 





/ 


=, something up or moving itself along — because it A Joseph upcycled 
<— an old remote- 


ine L has only one Raspberry Pi for the head where the control car for his 


02 Fit the robot frame into the RC car, then Al is based.” ems 
install Raspberry Pi, webcam, radio speakers, 
microphones, and Android Things in the robot's head. Software trials 
Joseph first tried using the open-source 
TensorFlow (magpi.cc/tensorflow) and YOLO for 
object detection, but really had in mind something 
more like a Movidius Neural Compute Stick to 
handle face detection (which he didn’t have). 
Instead, having consulted projects such as the 
Personal Assistant Robot (magpi.cc/parobot), he 
turned to SSH and live video streaming, which did 
a great job. “I can control the robot from anywhere 
around the world using my cell phone or PC any 
time I want to,” Joseph explains — something 
with clear potential in war or disaster zones where 
medical workers’ lives would otherwise be at risk. 
Asuems suchas wiinein toa gaeatiey “Doing such projects where you don’t have the 
station or finding a recipe. Complete the wiring actual resources helps you to be good at recycling 
and robot casing. things and also teaches you how to be super- 
creative in life,” he says, modestly. 
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A pristine lawn Is really something, but maintaining 
it can be time-consuming - unless you have a 
Raspberry Pi-powered robotic |lawn-mower, 

Rosie Hattersley learns more 














Communications 
technology 
specialist and keen 
| DIY maker, Dirk got 
his first Raspberry 
Pi back in 2012 

and loves its ability 
to solve real-life 











problems. 
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anicured lawns have obsessed 

homeowners for centuries, giving 

the illusion of scale as well as order. 

However, as our lives become ever busier, 

maintaining a weed-free, neatly trimmed patch of 

erass becomes a tall order. Getting a robot lawn- 

mower to take the strain seems like a sensible 

solution, especially if, like PiMowBot creator Dirk 

Weyand, you have a 600 m? lawn to keep you busy. 
Dirk embarked on his PiMowBot project 

two summers ago, aiming to create a robot 

that was powerful and reliable enough to mow 

his sizeable garden weekly. Although other 

robot mowers existed, such as the ArduMower 

(magpi.cc/ardumower), they didn’t fit Dirk’s 

strict lawn-mowing brief in which “the 

PiMowBot mows the lawn lane by lane so that 

the lawn gets an even cut.” Instead, he set about 

creating his own robot mower, recruiting his 

business customer and co-designer Tim Esser 














A Aprototype version of PiMowBot shows off its generous solar panel 
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PiMowBot's solar panel takes 
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to help with the object modelling and 3D design 
(magpi.cc/pimowbotcase). One problem: Dirk is 
based in Schleswig-Holstein in northern Germany 
and Tim in Berlin, so the two collaborated via 
email. In fact, they’ve never met. Both have full 
time jobs, which meant keeping the project ticking 
along could be quite a challenge. 

Dirk aimed to keep the build costs to around 
€300 — nearly two years later he estimates the 
project has cost him nearer €1500, though this 
includes the cost of two 3D printers and two 
previous prototypes. Now it’s built, there are no 
significant running costs. “Solar power is free and 
the built-in hardware is robust and reliable and 
has no real wearing parts, except the battery,” 
Dirk says. 


False starts 
The core parts are a Raspberry Pi Zero, Raspberry 
Pi Camera Module, and Witty Pi mini (a clock and 
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PiMowBot receives 
instructions via its 
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Mowing 
enthusiasts can use 
telemetry to map 


Sensors keep the robot PiMowBot's route 
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a location in 
PiMowBot, it 
automatically 
selects a default... 


. The lawns of 
one of Cambridge 
University's 
colleges! 


PiMowBot is 
protected bya 
geofence theft 
deterrent 


It'll have 
instructions for the 
most efficient solar- 
Charging alignment 


PiMowBot's motor 
and L298N motor 
controller hooked up 
to Raspberry Pi Zero 
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Make a mower 





01 Download the 3D templates from magpi.cc/ 
pimowbot or create your own. The PiMowBot 

software is supplied as a 1MB tarball. Setup 

instructions are at magpi.cc/pimowbotsetup. 










A ~ sie power management module) plus GPS, solar panel, 
oe he battery, motor, and motor controller. 
electronic parts As well as the Raspberry Pi OS and the Witty 





Pi software, Dirk made use of standard lines of 
code from earlier versions of his robot mower. 
He coded most parts of PiMowBot in REBOL3 
(magpi.cc/rebol) since he’s been using the open- 
02 Attach sensors, the L298N motor controller, source functional programming language for 

and other hardware to Raspberry Pi Zero. The nearly two decades. Python and GPIO Zero are used 
full parts list is at magpi.cc/ pimowbotbom. to communicate with the I2C devices, sensors, and 
motor control drivers. 





™ Solar power Is free and the built-in 
Nardware is robust and reliable @ 


Getting a precise orientation reading was a 
challenge due to the influence of magnetic north, 
but Dirk overcame this by getting PiMowBot to 
automatically go through a calibration process each 
time it’s set up. 

He wanted to keep things as straightforward as 
possible, experimenting with various motors and 





0 For help setting up the hardware for your 
Raspberry Pi Zero robot mower, see Tim's 
videos at magpi.cc/pimowbotyt. drivers such as a Waveshare Motor Driver HAT to 


control the gearing, braking, and acceleration. 
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> Sensors check the 
robot's precise 
location and confirm 
which way it’s 
facing before 
mowing begins 


Vv ARaspberry Pi Zero 
is the brain of the 
automated mower 





However, the geared motors drew too much 
current, prompting a switch to an L298N dual 
H-bridge module. Further refinements included 
adding a more powerful motor, which also meant 
Tim needed to redesign the 3D case. 

The final version of PiMowBot was complete by 
the start of this year, with build instructions and 
the software all available from Dirk’s website: 
mMagpi.cc/pimowbot. 


Mow-tivational 
“The PiMowBot has two operating modes: an 
autonomous operating mode without induction 
wires in the ground, and a remote control mode 
to directly control the lawn-mower robot via its 
web UI and the location and orientation sensors 
on the lawn,” explains Dirk. He’s used the Camera 
Module for previous Raspberry Pi projects and is 
keen to further refine the optical object/obstacle 
detection with real-world testing during the 
summer months. 

Although PiMowBot was intended as a 
“sophisticated hobby project” to work on in 
his and Tim’s spare time, Dirk is planning new 
models, including an XXL PiMowBot model and an 
intelligent system in which multiple PiMowBots 
operate alongside each other and share the mowing 
task. All hail our future mowing gods! 
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NES frame 


Ashley Green doesn't need to fire up his NES console 
to enjoy gd pang of nostalgia, thanks to his cart-based 


124 





Ashley Green 


Ashley is an 
instructional 
learning designer 
in London anda 
self-confessed 
entry-level geek 
who's also spent 
time as a graphic 
designer and video 
editor. In his spare 
time he enjoys 
looking for creative 
solutions to non- 
existent problems. 


retro art frame, as David Crookes discovers 


ixel art was Once a means to an end: a 
way of creating graphics in the early days 
of computers and consoles when visual 
capabilities were far less advanced than today. 
It combined tiny blocks of colour, often using 
a limited palette, and you only need to look at 
games from the 8-bit and 16-bit era to see many 
striking examples. 

Today, pixel art invokes pangs of nostalgia and it 
has evolved into a much-loved digital aesthetic in 
its own right. Ashley Green is certainly a huge fan, 
which is why he sought a quirky way of displaying 
his favourite pixel art, hitting on an idea that also 
paid homage to the past. 

“T’m the proud owner of a few Raspberry 
Pi computers and I’m always looking for new 
and interesting ways of using them, with retro 
gaming being the main driver,” he says. “Having 
previously used Raspberry Pi3 ina mini-replica 
NES case, I always thought something was missing: 
the classic NES cartridge itself. There’s something 
extremely satisfying about handling physical 
media that you don’t quite get with emulation.” 





Be careful: the case will need to be cut. Ashley has also used 
black vinyl for a finishing touch 
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As well as connecting via GPIO, Raspberry Pi Zero can be 
simply hooked up using cables 


Playing with power 

Rather than amass a large collection of cartridges 

— “T didn’t want to break the bank or shelves with 
stacks of old games” — Ashley felt that a single cart 
could be used to showcase the style of art he loves. 

Inspired by a project that turned an NES case 
into a full handheld system complete with screen 
and controller, he decided to turn a cartridge into 
an art frame which could then be placed in his 
study as a constant reminder of the past. 

“T thought it would allow me to appreciate the 
time and effort that went into the artwork and 
give mea little preview of classic NES games,” 
he reveals. 


Let’s-a-go! 
Grabbing a Raspberry Pi Zero W and a 3.5-inch 
screen that he was using for another project, he got 
to work. “Not wanting to destroy an original cart, 
I searched online and found a new blank cartridge 
shell. All I then needed was the USB and HDMI 
cables as well as a slim battery pack.” 

Since the screen is placed in the area usually 
reserved for the cartridge label, the build required 
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Search for a ‘replacement 
for-Vang(e(e[-m-Jal~1\ moval lla(-MimVeleme (olan 
WZclalmkeMet-laat-\e(-m-lame)ale|lat=l morales 


1 Pixel art invokes pangs 
of nostalgia and it has 
evolved into a much-loved 
digital gesthetic & 


some cutting into the plastic. Most of the project, 
however, involved setting up the software, with 
Ashley using the cloud-based digital signage app 
Yodeck. This allowed him to create, schedule, and 
upload videos and images from his computer or 
smartphone, although he says OXMPlayer would 
work well for offline creations. 

“T found the best process was to upload media 
and create a playlist that I could place on a layout 
that suited the screen,” he says. “I’ve chosen to 
use mine to show a mix of artwork, game footage, 
and classic NES commercials, but I’ve also used it 
to show off an action RPG called Induction Quest, 
which I created in Unity. It certainly makes for a 
ereat conversation piece — I’ve had a few people 
ask me what it is during my work video calls.” 





RETRO GAMING NES FRA Project Showcase 


No original carts 
were harmed 


Connect the 
screen via GPIO 
for a slim fit 


The battery packs 
last for about 
Six hours 


aM al=m o)ce)(-reimet-soe- Bc Rotel alers 
320x480 LCD HDMI screen to 
display the retro footage 


The media can be 
streamed via WIFi 


Yodeck is free for 
single-screen use 





Ashley has tramed his cartridge, shown here running tootage trom his own game, Induction Quest. 
He's currently working on SNES and VHS cassette versions 
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Project Showcase 


projection 


A Raspberry Pi-controlled video 
projection proclaims the rights of 
Black people. Rosie Hattersley gets 
the message 





Kareem 8 

Rahma efore daybreak one morning in June 2020, 
a huge 120100 ft (30.5*36.5m) video 

Egyptian-American projection appeared on the wall of the Gold 

Kareem is a NY- Medal Flour Mills building in Minneapolis. Gil 

based artist and Scott Heron’s iconic track The Revolution Will Not 


media entrepreneur. 


tateaei undead The Be Televised played over a looped set of images and 
Nameless Network video clips featuring US civil rights leaders. The 
and The Museum of installation was a powerful message of how things 


Pizza and previously 
worked at VICE. 


must and will change. The thought- provoking 
projection is powered, of course, by Raspberry Pi. 
Its creators, artist Kareem Rahma and 
entrepreneur David Dellanave, were only too happy 
to fill The MagPi in on how the project came about. 


Historical significance 

Kareem explains: “The idea was to display a 
juxtaposition of peaceful protestors with violent, 
oppressive police and elevating the names of Black 
people who have been killed by police in America.” 





David Having had the germ of an idea for such a project, 

Dellanave New York-based Kareem tweeted asking for someone 
to help him make it happen. Minnesotan David, who 

Entrepreneur he’d worked with a decade previously, responded. 


David is a coach, 
gym owner, and 
olive oil importer 


The two worked remotely until the time came to 
install their project at its location. 


who has been David suggested making use of Raspberry Pi. He 
deeply involved describes it as his “go-to for small projects and 
in Open-source ‘ 35 ‘8 

hats display dashboards” at the gyms he administers, 
technologies since -_ ; 
the late 1990s. rather than politically charged public statements. 


“ve never done anything outside the realm of the 
strictly practical, so this was a cool opportunity to be 
a part of,” he says. 
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Raspberry Pi Zero auto-mounts 
the USB drive and plays 
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Kareem previously 
created a 

°- ' projection map for 
| New York's The 
Museum of Pizza 
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Black Lives Matter message 
He's written a 


ee .; F : : poetry book: We 
. : | we Were Promised 


Flying Cars 
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have access to the projector 
once it was at the location, 
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Project Showcase | BLACK LIVES MATTER PROJECTION 





A The projection 
featuring iconic civil 
rights campaigners, 
such as Martin Luther 
King, can be seen 
across Minneapolis 


SOM 


WHW.MOVEM ENTMINNEAPOL Is 


Raspberry Pi Zero's low cost 
appealed partly because the 
setup might get confiscated 


or destroyed A. David usually uses Raspberry Pi for displays at his gym 
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Due to the nature of the project, there was 
always a risk that “the setup could get confiscated 
or destroyed,” says David. “So it was a huge 
advantage to have hardware that was cheap enough 
to be practically disposable.” 

Kareem is also a newcomer to public art displays, 
though he did help produce a projection mapping 
project for The Museum of Pizza in New York! 

For the Black Lives Matter projection, 

Kareem says: “We wanted to do something 

that would shock people a little bit, make them 
uncomfortable, and take advantage of this period 
of calm that was happening at night-time due to 
politicians successfully suppressing protests.” 
They worked with producer Hayley Pappas, 
creative director Smiley Stevens, and editor Khalil 
Anderson in Los Angeles to produce the first set 
of images and videos. Subsequent sets of content 


BLACK LIVES MATTER PROJECTION | Project Showcase 


for the display were suggested by the local 
community in Minneapolis, as well as including 
transcribed speeches by Malcom X, James 
Baldwin, and leaders. 





A Kareem previously helped 
create the story of pizza 
through time for a dedicated 
Museum of Pizza. Only in 
New York, right? 


M With protests in cities across the US 
resulting in government-imposed 10pm 
curfews, thelr projection was a risk @ 


Long-distance protest piece 
Minnesota-based David already had all the parts 
the project required. “I chose the non-wireless 
Raspberry Pi Zero specifically so there were no 
remote attack vectors possible. It’s more than 
powerful enough to play the content with 

no issue.” 

He built a small tiltable platform for the 
projector from wood scraps in his garage. The 
setup runs off a small generator, so it’s mobile 
and not dependent on a power outlet. 

The software side worked perfectly from the 
first go, he says. The advice of other Raspberry 
Pi and commodity hardware users “cannot be 
overstated” says David, who admits he’s not the 
most talented coder or software engineer. 

Any tweaking needed was to get the optimum 
projection location so it covered the entire Gold 
Medal Flour building. “The site is historic, iconic, 
and massive. It’s also central to Minneapolis and 
can be seen from different parts of the city,” 
explains Kareem. With protests in cities across 
the US resulting in government imposed 10pm 
curfews, their projection was a risk. 

Responses to the projection were immediate 
and very enthusiastic. “We’re very happy with 
how the idea has been received and hope that 
our project has inspired others,” says Kareem. 
“We'd love to see others replicate the idea, 
especially with permanent installations!” 
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Warning! 
Public projection 


Be mindful of local 
laws regarding public 
screening in your area. 
Seek permission from 
the owner of the wall or 
projection surface, or 
provide your own screen. 
Adhere to public safety 
regulations. And be 
mindful of broadcasting 
regulations in your 
area. You need a ‘non- 
theatrical’ film licence 
to show films and TV 
programmes in public in 
the UK. 


magpi.cc/ 
projectionlaw 
magpi.cc/showingfilms 
magpi.cc/filmlicence 


ES) Project Showcase | THE SWIRL MACHINE 


The Swirl Machine 


Make fantastic art with wine using The Swirl Machine, Rob Zwetsloot picks 
gd nice merlot and proceeds to ‘swirl his style’ 


rt comes in many forms, and for this 

project it takes the form of an interactive 

wine art creator called The Swirl 
Machine. It’s a lot more complicated than it 
might sound, though. 

“The Swirl Machine is an interactive, digital- 
meets-the-real-world machine that swirls Santa 
Maria Valley wine and turns it into a digital piece 
of art,” say the team from KPS3, the marketing 
agency behind The Swirl Machine. “It was created 
and developed by KPS3 for Visit Santa Maria Valley. 
The machine allows users to select their ‘Fill Level’ 
and ‘Swirl Speed’. In real-time, the user can watch 





Rob Gaedtke, the glass fill, swirl, and splash the wine onto a / QZ Ts 

Jonathan piece of paper, creating an original Santa Maria- Pa) | So. Te 

Rutheiser style spill artwork. Every swirl and spill will be ——— a, maul || 
unique to each individual user.” A Alot of art creates a lot of mess 

KPS3 is an 


integrated ' 
marketing agency 
that works with 
companies across 
the globe to find 
insights in data and 
bring them to life. 


magpi.cc/9yrkJW 
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Warning! 
Spinning glass 


If you choose to recreate 
this project, please fix 
glass on a spinning 
turntable carefully (and 
at your own risk). 


> Thousands of pieces 
of art have been 
created - is your 
piece on display? 
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satan 2 
A sucker arm 


picks up paper for 
vorc=roldlalemielelarclas 


The wine glass is r- . 

foe 
filled and swirledto [7 . y Your art is afhixed 
WielUl ams) el =rel | irer=1aLe) ats ’ ” | | # here for its close-up 





It’s a bit like a Rube Goldberg device, albeit 
without the Powerhouse music playing. The result 
of your swirl is sent to you as a photo, and there’s 
even a fun personality result that comes with it. 

“The idea came on a car ride to Santa Maria 
Valley,” the KPS3 team explain. “The team was 
playing around with the idea of capturing slow- 
motion swirls, which led to how interesting wine 
spills are, and that led to The Swirl Machine. The 





>» The video of a 
user's swirl can 
be replayed 


> The Swirl-nalysis 
takes into account 
the final art and 
your settings 


> The queue lets you 
watch the swirls 
ahead of you 


M\n real-time, the user can 
watch the glass fill, swirl, 
and splash the wine onto 
q piece of paper @ 


> More than 1600 
people have 
created about 
2000 swirls 


fact that it was a spill fit perfectly into the vibe 
of Santa Maria Valley’s wine experience... if you 
spill a little, no one really cares. And because of 
who KPS3 is as acompany, it clearly had to push 
technical boundaries.” 


> Artis very cool, 
however you 
make it 


Making a splash 

At the time of writing, there have been around 
2000 ‘swirls’ on The Swirl Machine’s website 
(magpi.cc/9yrkJW), and the machine has been 
made possible thanks to a Raspberry Pi. 


<0 We love the arm with 
an air compressor 
that sucks up paper 
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ES) Project Showcase | THE SWIRL MACHINE 


Swirl your style 
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SELECT 
YOUR 
SWIRL 

SETTINGS 













First, you need to select how full the wine 
01 ae 3 

glass is. This tells the pump how much wine 
to dispense into the glass. You can also choose the 
amount of ‘swirl’ for your glass, which sets a target 
speed for the spinning wine plate. 


Lone 


ye [Mes oooe 


: ST 4 





02 A gripper arm with an air-compressor- 
powered suction cup grabs your piece of 
special paper. It brings it to the paper holder, where 
the paper is then moved into position. Wine is 
dispensed, the glass is spun, and art happens. 








a} A camera records the footage of the swirl, and 
a different camera takes a picture of the final 
piece. As the wet paper isn't perfectly straight, the 
image is processed to make it look perfect before > 
being shared with the creator. 
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The complete machine 
is a masterpiece of 
messy art and many 
electronics 


A Raspberry Pi 
takes photos of the 
final piece 





“We like Raspberry Pi because it has a very low 
barrier to entry,” the KPS team say. “For only 
S35 you get a fully functioning computer with I/O 
capabilities. The community behind Raspberry 
Pi is also active and helpful, which means you 
eet software packages that are thoroughly tested 
and you never spend too much time figuring out 
solutions to problems. We’ve used Raspberry 
Pion many different projects in the past [...]. 
Whether it’s powering a media server, emulator, 
live-streaming client, or The Swirl Machine, we 
know it’s more than powerful enough to handle 
the tasks we’ve thrown at it.” 

The machine uses a number of technologies. 
The website is hosted in AWS. A robot arm grabs 
paper and moves it along the swirl production line. 
Arduinos control the wine glass, and a spinning 
plate swirls the glass. Each piece of wine art 
is unique, including the corner splash that we 
managed to make during our go with it. Hl 





The only guide you 
THE OFFICIAL need to get started 
with Raspberry Pt 






am How to use your 
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@ Learn how to set up your Raspberry Pi, 
install an operating system, and Start using it 








@ Follow step-by-step guides to code your 
Own animations and games, using both the 
Scratch 3 and Python languages 


® Create amazing projects by connecting 
electronic components to Raspberry Pi’s 
GPIO pins 


£10 with 
worldwide delivery 
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Maker Guides 


i oe © 





If you bought a Raspberry Pi to learn 
how to make electronic gizmos, you're 





in for a treat 
Make an LED light circuit 


Basic prototyping 
components 





RASPBERRY Fl 4A 
TIPS & TOOLS 


LEDs and switches 
A huge range of physical and digital tools to 


improve your making skills 







Build a reaction timer 


Tools for building and prototyping 
Tools for storage 


Tools for connecting electronics 







Tools for soldering 
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Maker Guides 







Everything you need to make this popular 
Raspberry Pi project 


Assembling a simple mirror 
Setting up 

Voice control 

Configuring your magic mirror 
Facial recognition 


Create modules for your mirror 


Diagnose and fix issues on your 


Raspberry Pi 8 ~- le Mate Rhee Waa Rate Cen 
= +a » 16PTO| < Rosoberry Pi 4 Model B 
(Raspberry Pi 2018 


| China M 1904 
cGAkus 


| Trxcom® |5| 
| TRIGOO2GHENL 






Basic problems 1) =ag + 
Boot problems = 
Network problems eel 
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E OF TOOLS YOU CAN USE FOR sae oe 
ERE ARE 50 PHYSICAL AND DIGITAL TOOLS — 
NON INE SKILLS. BY MARK VANST 





hether you are new to making with 

Raspberry Pi or have been at it for years, 

there are always new tools and techniques 
to be learned. For the new arrival to the making 
community, this list will be a great resource to 


Warning! introduce you to tools that you may not have heard of 
before, and a short cut to get to the bits of software 
Some of these tools use that work best for Raspberry Pi projects. If you’ve been 
faatelialsmcitcvesa(eliavarel ave! P . P 
heated parts. Always follow doing this for a while, you may want to count how 

Sonne On eae many of these tools are already in your makerspace. If 
elaleW 1-1] altar \Vom acre cre . 
elements unattended. you get to 50, you probably need a bigger makerspace. 
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3D PRINTER 


a 





The 3D printer is a fairly recent 

addition to the maker scene. To be 

able to print something solid a few 
years ago was like science fiction, but now 
it’s areality. Printers come in many sizes and 
prices, so you can match your printer to your 
budget and requirements. There are several 
choices for filament too, such as PLA (a good 
beginner’s choice) or ABS and many other 
more specialised types. If you have the time 
and patience, you can get a small unassembled 
one for less than £100, but for better quality 
(and less frustration) you may want to spend 
a bit more. 


Breadboards are 

solderless circuit 

boards and allow for 
fast prototyping of projects. The 
boards come in several sizes 
and consist of a matrix of small 


connector holes into which 
components and jumper wires 
can be inserted to make circuits. 
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LEDs (light-emitting 
diodes) are a bit like very 
small and efficient light 
bulbs. They glow when current is 
passed through them, but they 
need to be connected correctly. 
Because they are diodes, the 
current only flows one way, unlike 
in conventional light bulbs. 


/ 


Resistors are used in 
electrical circuits to reduce 
current flow. They are 


used for many reasons, including 
changing the brightness of an LED. 
They can be a fixed value, with 
stripes to indicate the resistance; 
or variable, with a slider or dial to 
change the resistance. 





There are several 
code editors 
available for 
Raspberry Pi. The default 
one now pre-installed 
in Raspberry Pi OS is 
Thonny. If you are feeling 
adventurous, you could try installing Mu 
or PyCharm. 





het 


There are many types of electronic 
sensors. You may want to detect light 
or vibration, 

sound, or heat. There 

are sensors for all of 

these and many more. 

Sensors allow us to 

capture data about the 

world around us. 





TOOLS FOR 
BUILDING & ———— 
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Connect one component to another without 
soldering, tape, or breadboard. 


Pinches connectors onto wire, fixing it to the 
connector. Can also can cut/strip wires. 


You’re going to need several different 
screwdrivers of different sizes/types. 


Stanley knives are good for most work, but you 
might also want something lighter. 


Tweezers can get you out of a fix when that little 
screw disappears. 


Sometimes there is no substitute, but it’s not 
suitable for the young ’uns. 


Most of the time a cordless is best. 


Hacksaws for metal/plastic parts, jigsaw/ 
circular for big builds, mitre saws for angles. 


If you are making any sort of moving robot, 

you’re probably going to need wheels or 

gears. Some kits come with them, such as the 
CamJam EduKit 3. You can buy them separately or even 
3D-print them. 


A good set of long-nose/snipe-nose pliers 
should be on hand at all times. 








Wrgulilieg 


Add extra storage to your Raspberry Make sure you have multiple microSD When making projects, you 

Pi with a USB thumb drive. You can cards. An 8GB card can be used to quickly rack up additional 
store more files than the microSD install Raspberry Pi OS and other kit — not to mention cables, 
card, and you can transfer _< ~~ ‘operating systems. It’s a good idea to components, and Raspberry Pi 
files from another a) al : | have your regular microSD card boards. Keep everything in one 
computer to your a > - and at least one other card place by adding a storage box 
Raspberry Pi. eC . = e for testing out projects. to your shopping list. 









20 
CARD TRIMMER 






These machines are very 
much like plotters, but have 
a knife instead of a pen. They can 
cut very intricate designs out of paper and 
fairly thick card. They can be a bit temperamental 
and often need a sticky carrier sheet to work well. 


Laser cutters and 

engravers fire a 

laser at a material 
to either cut through it or to leave a mark or indent on 
the surface, depending on the intensity of the laser. 
Very effective for cutting irregular wooden shapes. 
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guides available to make life easier. 


yruliling 





Acrylic plastic sheeting is very 

1Koletednlr-balemer-belo\-m@blmblyeatcar<| 

saw or CNC router, whereas 
thermoplastic sheets are malleable when 
heated with a heat gun. Once cool again, 
thermoplastic retains its new shape. 


magpi.cc/electricpaint 












This material is usually 

supplied as granules 

or beads. You can heat 
them up in boiling water and 
they will clump together ina 
mass. While still warm, you can 
mould the plastic before it sets 
hard in ten minutes or so. 





magpi.cc/alufoil 











GPIO (general-purpose input/output) For some projects, you may want Jumper wires connect Raspberry Pi 
pins are the interface between to connect a HAT or pHAT to your GPIO pins to electronic components. 
your Raspberry Pi and electronic Raspberry Pi, but not place it right on Use them with a breadboard to 
components. Until you learn which top of the board (or rear of Raspberry prototype your circuit, or solder them 
pin is which, you’ll need a guide. Pi 400). A female-to-male 40-way directly to components. Be sure to get 
There are several GPIO rulers and ribbon connector will enable you to a variety of different colours to make 









extend the reach of the GPIO pins. your project easier to understand. 
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Feature 


TOOLS FOR 
00-2 


You need to be able 
to measure current, 
resistance, and voltage in 


your circuits. Digital multimeters 
can cost as little as £10. 


This equipment enables you to clean melted 
solder from components on a printed circuit 
board, allowing their removal or replacement. 





A handy stand to place a soldering iron while it 
is still plugged in and hot. The sponge should be 
wet to clean the end of the iron. 


An absolute necessity for soldering or 
desoldering components onto printed circuit 
boards. For detailed work, an iron witha 
pointed end is best. 










A3 
NUTS, BOLTS & SCREWS 


Usually has a solid, heavy base with jointed 
arms with clips or holders at the end, anda 
magnifying glass for working on 

small components. 


Having a good range of sizes and shapes 

of nuts, bolts, and screws is absolutely 

necessary for making anything that you 
are not going to glue. Keep a jar full of spares. 
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When you have completed your 
project, you may want to document 
how you did 
it. Fritzing is a great 
program for laying out 
circuit diagrams. 


One of the most important tools you 
will use for just about any maker 
project is reference material. Your 

Raspberry Pi may have come with some tips 

and hints about making, and many kits have 

worksheets and Frequently Asked Questions 
sections with them. Also, make best use 

of the online resources that detail other 

people’s experiences: like Stack Overflow 

(stackoverflow.com) for information 

about any technical subject; blogs such as 

recantha.co.uk and blog.pimoroni.com; and 

of course the Raspberry Pi site (rpf.io) and 
magazines. If you’re stuck getting something 
to work, it’s likely someone else has had the 
same problem! 


You may want 

to visualise your 

build before starting, and there are 
many 3D software packages to help you for 
free, like Blender; or with free trial versions, 
like SketchUp. 
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ver the past few years, Raspberry Pi 
has gone from a small experimental 
computer to a very capable all-round 


connect electronics to a Raspberry Pi, you can use 
the same techniques to start inventing your own 
eadgets and electronic tools. If these are your first 









nwa 


144 








What 
You'll Need 


If you are lucky 
enough to have a 
Local electronics or 
hobby store, you will 
no doubt be able to 
find all the electronic 
components we will 
talk about for a few 
pounds, dollars, or 
euros. Failing that, 
there are many fully 
stocked online outlets 
that can provide 
them. All you will 
need to start with is 

a breadboard, some 
jumper leads, a 
resistor (200 to 470 ), 
and an LED. 


system, while still retaining its small footprint. 
It has embedded itself in the hearts and minds 

of makers, coders, educators, inventors, and 
electro-artists around the world. Its flexibility 


and computing power now makes it the 
eo-to platform for embedded systems 
(like smart devices) and workhorse 
tasks such as controlling other network 
systems or even robotics. The range of 
tasks Raspberry Pi can achieve becomes 
wider all the time as the community 
creates new ways to use it. 


Gateway to the new frontier 
Raspberry Pi has made a huge impact, 
not only on computer science education 
but also in the realm of makers and 
inventors. As well as being a really 
eood-value computer, it gives the owner 
endless possibilities of connecting 
other electronics to it to produce useful 
gadgets and impressive demonstrations. 
Raspberry Pi is your gateway to the 
new frontier of creative technology. 
If you can master the basics of how to 


steps into electronics, you have a very exciting 
journey ahead. 


Expand and experiment 

In the early days of home computers, most 
models had expansion ports of one sort or 
another and, very often, upgrading them 
involved opening up the case and soldering new 
circuits, or at least plugging in chips into empty 
slots. These days, you are lucky if your home 
computer has USB connectors for accessories, 
and plugging in home-made contraptions is 
definitely not recommended. 

Raspberry Pi is different because its design 
encourages the owner to plug in extra devices 
and even experiment with your own prototype 
circuits. Raspberry Pi has standard USB and 
Ethernet ports, a camera connector, WiFi, and 
HDMI video output. But the crowning glory of 
connectivity is its GPIO (general-purpose input/ 
output) 40-pin header, which provides the 
tinkerer with access to the inner workings 
of Raspberry Pi. You can even write 
code to control electronics that are 
plugged in to the GPIO pins. 
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3V3 power 5V power 
GPIO 2 (SDA) 5V power 
GPIO 3 (SCL) Ground 
GPIO 4 (GPCLKO) GPIO 14 (TXD) 


Ground GPIO 15 (RXD) 
GPIO 17 GPIO 18 (PCM_CLK) 
GPIO 27 Ground 
GPIO 22 GPIO 23 
3V3 power GPIO 24 
GPIO 10 (MOSI) Ground 
GPIO 9 (MISO) GPIO 25 
GPIO 11 (SCLK) GPIO 8 (CEO) 
Ground GPIO 7 (CE1) 
GPIO 0 (ID_SD) GPIO 1 (ID_SC) 
GPIO 5 Ground 
GPIO 6 GPIO 12 (PWMO) 
GPIO 13 (PWM1) Ground 
GPIO 19 (PCM_FS) GPIO 16 
GPIO 26 GPIO 20 (PCM_DIN) 
Ground GPIO 21 (PCM_DOUT) 
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PIO pi 
You can use Raspberry Pi’s GPIO 

pins to pass electrical voltage to and 

from other components. Some of the 

pins have specific uses, such as power 

or ground connections, and others can be 
configured with software programs to send 
signals between Raspberry Pi and the rest of 

the circuit. Above is a breakdown of all the pins. 
Look carefully at physical pins 1 and 6: these will 
be the pins we use in our LED circuit later. Note 
that the pin numbers aren’t the same as the GPIO 
numbers; for example, GPIO 2 is actually physical pin 3. 
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Allthe holes inthis row are PR 
TalX=)eatslaNvmere) alat=veax=ve| 





All the holes in this row are 
used for power and are all 
Tal <=) gate \tNVmexe) al at—roa re! mn “ 
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Breadboards come in several different sizes and 


are made of plastic with a matrix of holes. In 
each hole is a connector which joins it to other 
holes on the same row. 

The larger breadboards have two long rows of 


holes at the top and bottom. Sometimes called 
‘rails’, these are generally used for power and 
eround connections. They are connected together 
as indicated on the diagram above. 
ea i The inner part of the breadboard has two 
sections of holes. Each section has rows of five 
holes which are connected as indicated on the 
diagram. The two halves of the breadboard are a 
mirror image of each other. 

The break along the centre of the breadboard, 
often known as the ‘gutter’, enables mounting 
of integrated circuits (chips) with the legs of the 











chip going either side of the break Breadboards come in several sizes 
: : ; Kom =Jalole]Kom e)ce)Kelavse)ialeme)m-MUlel=! 
See magpi.cc/breadboard for more info. variety of projects 
<b 
ap 
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NB 
Make an LED light circuit 


a 














Let’s dive into some practical circuit making be tolerated by Raspberry Pi, but in some cases 
with an example of how we can use the GPIO it can cause a System crash or even damage to 
pins on the Raspberry Pi to make a circuit. We the hardware. 





will go into the details of what the components 
are ina little while, but let’s look at what a 
circuit actually looks like on a diagram. We will 
















use the power source of Raspberry Pi to light an 02 Build the circuit 

LED (light-emitting diode). When electricity is Connect the components as shown in the 

passed through an LED, it glows. We will also need wiring diagram below. Take careful note of the 

a resistor in our circuit to limit the amount of CPO wins that you are commecting. Ihe precise 

electricity that goes through the LED. If too much positioning of components on the breadboard is 

electricity flows, the LED may burn out. not so important, but make sure that the LED’s 

longer (positive) leg is connected to the 3V3 power 

When connecting pin via the jumper lead. 


components to the Raspberry Pi, it is 
always best to have the power off and 
unplugged in case you make a mistake with 
your wiring. 03 Light it up 
When you are sure that you have 
COMmieched everyting Gorrecth,, plug in 
your Raspberry Pi. After a short time, the 





You ll need 


To build this simple 


iy Turn off the power LED should ibteatt up as soon as the power LED circuit you need 
Make sure you have shut down your Gy PIO ones cum Sioreieeisreral, Ihe clare He D)relerers the following: 
Raspberry Pi and unplugged its power cable. not light up, try connecting it the other 
Plugging in jumper leads while switched on may way around, as it will only work one way. > Breadboard 


> LED 

> 470 resistor 

> 2x male-to-female 
jumper wires 





Everything can be 
found in the CamJam 
Edukit #1 (£5) 
magpi.cc/edukit 





*teeetse # «& 
ah thtnhti @ @ 
see ee 


When the resistor and LED 
Sate fo) FYox-To Mla mtal-mel geass 
correctly, the LED will light up 











The wires we use to 
fore] a] at=req move) aa) eoteyal=lal a= 
are called jumper leads 





AV {-Meor-Va More) alat=xoi mexelan) olelal=1a1 83 
oN maarelelaitiale mial=laameyal 


FW el g=y-\eleler-lcel SS 





itireinirirtaetinhitebtitirtistientaetenetiienhtsa @# & 
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components 


“4 





Jumper leads 

These connect your components to the Raspberry 
Pil, Viney Cell clntese Inthe ieevailkeveye geinors) (areyavel 
connectors (you need female for the GPIO pins) 
and it’s a good idea to have a mix of both. 


LED 

Light-emitting diodes come in various 

colours. They glow when electricity 

flows through them. Because they 

are a diode, the current will only 

flow in one direction, so make sure | | 
that it is connected the right way round: 

the longer leg is the positive one and 

should be connected to the power (or GPIO output) 
pin. Always use a resistor in series with LEDs, 
otherwise they are likely to draw more current 
than they can handle and burn out. 


Resistor 
Resistors are available in various formats, but 
this is the most common format for prototyping. 
The coloured rings around the resistor 
& indicate how much resistance it 
provides. For more details 
about how to read resistor 
values, see magpi.cc/64. 


~ 








A small piezoelectric speaker is good for 
laatel.dlale sian] eltomalelisioxs 


Jsyetoy Com oy cel roy atgeyie 













Switch 

Switches make and break circuits. When 
connected in series in a circuit, a switch will 
allow or stop the flow of electricity. You can get 
switches that stay in the position in which they 
are set, or ones that you need to keep your finger 
CimrOkeeD ene Cilelit commected. 


Speaker 

Speakers can be huge and very loud or they can be 
very small — small enough to fit on a breadboard. 
These small speakers are called piezoelectric and 
are great for making robotic noises, but not much 
good for hi-fi music applications. 


Helelelaiaele 

Capacitors store and release electrical 
Chiakeee, Tey Calin ole Ucteval welts} (ein) 
OU lve eleva wre ll el smgelalete)a joy moniarele 

a greater flow for a short time. Be 

careful when using capacitors, as 

they can still hold charge after the circuit has 
eievelnl Chistetoimiakere realy 





Transistor 

Transistors are used in many types of circuits. 

They can be used either as an amplifier, which 

means that a small current goes in but a bigger 

current comes out, or as an electrical switch 

to change the amount of electricity 
flowing through circuit. A 


“ transistor has three legs or 
COMMeClOns side cimitter, the 
collection, and the base. 

servo 


Servos are used a lot in robotics for making 
things move. They can be connected directly to 
Raspberry Pi via the GPIO pins, but there are also 





Dee 
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A Aservo is a special type of motor that allows for precise 
(oto) a} 4ce)] me) mins ce) f-lile)atelm Colm llal=tolem ere)i1N(0l8) 


extra plug-in boards (or HATs) that make it easier 
to connect many servos and control them more 
easily. Normally we use digital servos which use 
PWM (pulse-width modulation) signals to turn the 
armature on the servo from one position to another. 


Batteries 

Batteries can be all kinds of shapes and sizes, but 
for simple electronics projects you will normally 
be using 1.5V AA or AAA type cylindrical batteries 
or 9 V square ones. Make sure you always have 
some spares or perhaps you may want to use 
rechargeable ones. Rechargeable batteries cost 
more, but can be used over and over. Make sure 
you connect batteries correctly and never directly 
connect the two contacts together, as even small 
voltage batteries can get very hot or even explode 
if ‘short-circuited’. 


Potentiometer 

Potentiometers are variable resistors and usually 
have a twisting knob or a slider to change the 
resistance. They have three connectors and can be 
used as game controllers or volume controls. Be 
careful if you are using a potentiometer instead 

Of a resistor in your LED circuit: if you turn the 
resistance right down to zero, you may burn out 
your LED. 









> Apotentiometer 
felgetelUlexcsourlal 
Vale lnele[elomeleinelels 
dare lama ate Waele 
converted to 
digital by an ADC 
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CamJam EdukKits 

There are currently three CamJam Edukits 
available: a starter kit with all the components 
and more to make our LED circuit, a sensors kit to 
explore getting input from the world around you, 
and a robotics kit with wheels and motors to make 
your Raspberry Pi into a robot. 
magpi.cc/camjamkits 





Adafruit Parts Pal 

The Adafruit Parts Pal is a more 
comprehensive kit. It contains 
many popular components and 
prototyping parts, including 

LEDs, resistors, cables, sensors, and 
mechanical parts. 
magpi.cc/partspal 


Elecrow CrowPi Educational Kit 
This is the daddy of all-in-one 
experimentation kits. There are 
chips and sensors, dials, speakers, 
numeric displays, and even a 7-inch 
HDMI touchscreen. It was developed with a 
Kickstarter appeal and is available directly from 
Elecrow in the US, or Amazon in the UK. 
magpi.cc/crowpi 
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Getting started 
with electronics: 
LEDs and switches 


Use Raspberry Pl's GPIO pins to Buid two simple 





Simon 
Monk 





Simon divides 

his time between 
writing and 
designing products 
for MonkMakes 

Ltd. Some of his 
better-known books 
include Programming 
Raspberry Pi (TAB) 
and The Raspberry Pi 
Cookbook (O'Reilly). 


simonmonk.org 


You'll Need 


> The Mu 
Python editor 
codewith.mu 


> Solderless 
breadboard 


> 5 x female-to-male 
jumper wires 


> Male-to-male 
jumper wire 


> 2x red LEDs 


> RGB common 
cathode LED 


> 3x 470 resistors 


> 2x tactile 
push-buttons 


These components 
are all included ina 
MonkMakes kit: 
magpi.cc/pibox1 


electronic projects. By Simon Monk 


two simple projects that use LEDs and push- 

button switches that are controlled bya 
Python program running on your Raspberry 
Pi. The first project uses an RGB (red, green, 
blue) LED to interface to the popular Cheerlights 
project. Cheerlights (cheerlights.com) allows 
users all over the internet to set each other’s LEDs 
to different colours just by tweeting. 

The second project is a reaction timer using 

LEDs and push-buttons to test the speed of 
your reactions. 


n this tutorial, you will learn how to make 


Set up some Cheerlights 


Install the code 

Before fetching the code from the internet, 
you should run Mu, which you will find in the 
Programming section of your main menu. If it’s 
not there, update your system to the latest version 
of Raspberry Pi OS (magpi.cc/rpiosupdate). 








A Figure 1 The Cheerlights wiring diagram 
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Running Mu ensures that the mu_code 
directory is created, into which we will now copy 
the program code. To do this, open a Terminal 
window and run the commands: 


wget http://monkmakes.com/downloads/pb1.sh 
sh pbi.sh 


This will copy the programs used in this tutorial 
into the mu_code directory, along with some 
other programs. 


M Push the component legs 
into the breadboard at the 
positions shown @ 


Place components 

onto breadboard 

Using Figure 1 as a reference, push the component 
legs into the breadboard at the positions shown. 
Bend the resistor legs so that they fit into the holes. 

Each hole in a row of five holes on the 
breadboard is connected together under the 
plastic. So, its very important to get the right row 
for your component leg. 

The resistors can go either way around, but the 
RGB LED must go the right way around, with its 
longest leg to row 2 (the one without a resistor). 
The push-button used in the MonkMakes kit has 
just two legs, but many similar buttons have four 
legs. If you have a four-legged version, put it on 
the breadboard in the orientation that leaves 
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Attaching electronics SRD 


" FVaveM o)lal-me)amaat-Meltal-)ar-lq-Mety-le Mm KoMere) al at-loal 
TO ad R ad S le C i l P l i 1H al- MC] a (OM (ol-lal-l¢-| ty olelg olek-Mlal olUlwAelels olbiy) 
@ pins of Raspberry Pi to the breadboard 
= r a. 7 we 4 


Z. 






A GPIO template makes it 
easier to find the right pin 
Wala Mtcolem-le-mece)alal=veadlale 
Mallave omkele (=v dell 


An LED can be turned on 
Vale Moyimv ital lam-MeavAtareyal 

rol cole lela meriiare m-Mel a (Om ella) 
Yea lavem-(w-lameoleinolela 


A solderless breadboard is used 
Ko avo) CoMdal=m=1K-1e14golal(omere)aaleleyal=lal a) 
FValo Moxe) alal-voamtal=laamceole(-14al-1¢ 





just one free row between the pins. You will also 
need to place a linking male-to-male jumper wire 
between rows 2 and 10. 


Connect breadboard 

to Raspberry Pi 
Again, using Figure 1 as a reference, connect the 
GPIO pins on the Raspberry Pi to the breadboard. 
A GPIO template will make this easier — if you 
don’t have one, you will need to carefully count 
the pin positions. It doesn’t matter what colour 
jumper leads you use, but if you stick to the 
colours used in the diagram, it’s easier to check 
that your wiring is correct. 


| 
| 


Your programs can tell that a switch has been 


pressed by connecting a switch to a GPIO pin 
Vatomasy-(ollavemdal-1me] (OM ollae-t-e-laMlalelels 








Tweet a new colour 
Now that your Raspberry Pi is looking out 
for changes to the Cheerlights colour, anyone can 





Running the program simply send a tweet mentioning @cheerlights 

To use this project, your Raspberry Pi must and the name of a colour; your LED should then 
be connected to the internet. Load and run the change to that colour. You can test this out by 
program 04_cheerlights.py using Mu. After a few sending a tweet such as ‘@cheerlights red’ and 
seconds, the LED will automatically set itself to after a few seconds your LED should change 
the current Cheerlights colour, checking every ten colour. You will find that after a few minutes, the 
seconds. Pressing the button will turn the LED off colour probably changes as someone else sets the 
until the Cheerlights colour changes. Cheerlights colour. 
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The RGB LED is actually 


three LEDs in one: 


red, green, and blue. 
(Clare late |ialemuatom ele) /i-16 


foley i arom Kon=)-(o1a a mt = D) 


(controlled by a separate 
(© = [ON ella) Meral-lale(-ssmual= 


o)Visleclimere)kelela 


GPIO 24 acts as an 

olU dole mm@Lelaclalmile)\as 
(o]U| om] = Oly Pa dalcoletelal 
the resistor, through 
the blue LED and back 
to Raspberry Pi's GND 
Col colblare Mexe)alarvoit(olayy 


Nau DAV llmeles\\acls 
aaleleiamelllaa=lalmc\cuimerclan 
so each LED needs a 











resistor to reduce the 

(oi ldc= alam o)ce)kcreiilale malate 
LED and/or the GPIO pin 
of Raspberry Pi. 


When the switch is 
pressed, it connects GPIO 
‘ollawtomce(oidlaleme\smr- lam ialelei®) 
to GND (oV). 


PNaWlalcsigar-lmelelieaeye 
resistor keeps GPIO 25 
at 3.3V until the switch is 
pressed - that overrides 
the effect of the resistor, 
making GPIO 25 OV. 
Without this, GPIO 25 
Nfolul Kell ek-m- lm iley-l i arom lalelets 
rele) Km Kom r= lsx-m nalelel=yal are! 
from electrical noise. 


Build a reaction timer 


Dismantle the breadboard 

First, pull the jumper leads off the GPIO 
pins on the Raspberry Pi and then pull all the 
components and wires off the breadboard so that 
it is ready for the next project. 


Place the components 

This time, using Figure 2 as a guide, push 

all the component legs into the breadboard at the 
positions shown. It doesn’t matter which way round 
the resistors and buttons go, but the LEDs have a 
positive and negative end, so must go the correct 
way around. The positive end of the LED (marked ‘+’ 
on the diagram) is the longer leg and this should go 
to the same row on the breadboard as the resistor. 








ase ee 
“se ee 





es ee ee ee 
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se ee @ 


A Figure 2 The Reaction Timer wiring diagram 
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Raspberry Pi 





A schematic 
diagram of the 


Cheerlights project 
GPIO 25 
GPIO 24 


GPIO 18 
GPIO 23 


Running: OF _reachions.py 


Press the button next to the LED that lights up 
right 

Time: 465 milliseconds 

Press the button next to the LED that lights up 
left 

Time: 365 milliseconds 

Press the button next to the LED that lights up 
left 


A. Figure 3 The Reaction Timer results in the Mu console 


Connect breadboard 

to Raspberry Pi 
Using Figure 2 as areference, connect the GPIO pins 
on the Raspberry Pi to the breadboard using five 
female-to-male jumper wires. 


Running the program 

To use the reaction timer, load and run 
the program 07_reactions.py in Mu. When the 
program starts, you will notice that the bottom 
part of the Mu window shows a message telling 
you to ‘Press the button next to the LED that 
lights up’ (Figure 3). 

After a random amount of time, one of the LEDs 
will light, and you should press the button next to 
that LED as quickly as possible. You will then get 
a message telling you how many milliseconds you 
took to press the button. 

The code includes checks to make sure you don’t 
try to cheat by pressing both buttons at once, or 
pressing the buttons before an LED has lit. Hl 
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DOWNLOAD 





04 cheerlights.py 


> Language: Python 3 y) magpi.cc/pibox1 git 


001. 
002. 
003. 
004. 
Q05. 
006. 
007. 
008. 
909. 
010. 
Oia 
O12: 
013. 
014. 
Q15. 
016. 
017. 


O7_ 


# @4 cheerlights.py 
# From the code for the Box 1 kit for the Raspberry 
Pi by MonkMakes.com 


from gpiozero import Button, RGBLED 
from colorzero import Color 
import time, requests 


update period = 10 # seconds 

led = RGBLED(red=18, green=23, blue=24) 
button = Button(25) 

cheerlights url = "http://api.thingspeak.com/ 
channels/1417/field/2/last.txt" 


old color = None 


def pressed(): 


reactions.py 


> Language: Python 3 


001. 
002. 


003. 
004. 
905. 
006. 
007. 


008. 
909. 


010. 
011. 
912. 


013. 


Q14. 


Q15. 


016. 


Q17. 


018. 
Q19. 


020. 
O21. 


O22. 


# @7 reactions.py 
# From the code for the Box 1 kit for the Raspberry 
Pi by MonkMakes.com 


from gpiozero import LED, Button 
import time, random 


left_led = LED(25) 
right_led = LED(23) 
left_switch = Button(24) 
right_switch = Button(18) 


# find which buttons pressed @ means neither, 
-1=both, 2=right, l=left 
def key_pressed(): 
# if button is pressed is pressed will report 
false for that input 
if left_switch.is pressed and 
right_switch.is pressed: 
return -1 
if not left_switch.is pressed and not 
right_switch.is_ pressed: 
return @ 
if not right_switch.is pressed and 
left_switch.is_ pressed: 
return 1 
if right_switch.is pressed and not 
left_switch.is pressed: 
return 2 





018. 
919. 
Q20. 
Q21. 
Q22. 
923. 
Q24. 


Q@25. 
Q26. 


Q27. 
028. 
Q29. 
930. 


Q23. 
Q24. 
Q25. 
Q26. 
Q27. 


028. 


Q29. 


930. 
Q31. 
Q32. 
933. 
934. 
Q35. 
036. 
Q37. 
038. 
939. 
040. 
041. 


042. 
043. 
044. 
Q45. 


THE FULL CODE: 






led.color = Color(@, @, @) # LED off 
button.when_pressed = pressed 


while True: 
try: 
cheerlights = requests.get(cheerlights_ url) 
color = cheerlights.content 


# the color as text 
if color != old color: 
led.color = Color(color) 
# the color as an object 
old_ color = color 
except Exception as e: 
print(e) 
time.sleep(update_period) 
# don't flood the web service 





while True: 
left_led.off() 
right_led.off() 
print( 
"Press the button next to the LED that lights up") 
delay = random.randint(3, 7) 
# random delay of 3 to 7 seconds 
led = random.randint(1, 2) 
# random led left=1, right=2 
time.sleep(delay) 
if (color == 12) 
print("left") 
left_led.on() 
else: 
print("right") 
right_led.on() 
t1 = time.time() 
while not key_pressed(): 
pass 
t2 = time.time() 
if key_pressed() != led : 
# check the correct button was pressed 
print("WRONG BUTTON") 
else: 
# display the response time 
print("Time: " + str(int((t2 - t1) * 1000)) 
milliseconds") 


+ 
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Magic mirrors, How do they work? Are they really 


magic? Are they only for the aqdvanced maker? 
PJ Evans goes through the looking glass 





out there. Initially created by combining old laptops and 

semi-reflective observation glass, they appear as normal 
mirrors but with text and images that appear to float in mid-air. 
The information displayed is typically what you need as you’re 
preparing to leave the house: weather, news headlines, and transit 
information. Although they come across as advanced builds, the 
community behind the projects have made significant advances in 
making magic mirrors accessible to all. Let’s take a look at one of 
these makers and then have a go at building our own mirror. 


M agic mirrors have to be one of the most popular projects 
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Information is displayed 
in corners, typically in 
high-contrast black 
and white 











The frame needs to 
be deep and sturdy 
to accommodate the 
display and computer 


F | An LCD screen; for 

, best effect, 1t needs 

| to removed from its 
| casing to sit flush 


This is semi-transparent 
‘observation glass’: 
darker than a usual 

mirror, but it allows the 
display to show through 





MAGICMIRROR* 





=r 





ee MagicMirror 
Creating a good magic mirror requires system takes away all the programming np 
experience in many disciplines including and design pain. Best of all, you can expand - 
carpentry, electronics, programming, and the capabilities of your mirror through the 

o 4 & = 
graphic design. Fortunately, the team at hundreds of community plug-ins available Ore isi — _ 
MagicMirror?, headed by Michael Teeuw and, if you wish, you can write your own. It's 
(see The MagPi issue 54, magpi.cc/54), have no wonder it won the number one slot in our 
not only compiled tutorials and fostered a best projects feature for issue 50. a 

oc 


great community, they've also built their 
own open-source application. This modular 


magicmirror.builders eT 
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| BUILD THE ULTIMATE MAGIC MIRROR 


Assembling a 





Would you like g magic mirror, but don't fancy all that carpentry? Here's a first 
project to ease you In without having to reach for the band-saw 


You'll Need T here have been some impressive magic 
es a mirror projects as makers around the 


> Ikea Ribba 18x24 
picture frame 
magpi.cc/ribba 


> Official Raspberry 
Pi 7" Touchscreen 
magpi.cc/ 
touchscreen 


> A5 observation 
mirror 
magpi.cc/a5mirror 


> Gaffer or duct tape 


> Velcro or foam 
sticky pads 


Tip! Not for Zero 





globe challenge each other to improve 
on previous designs. Although the results are 
undoubtedly impressive, it can make the hobby 
look a little daunting to the beginner, especially if 
you don’t have access to the necessary equipment 
to build a custom frame. In this tutorial, we’ll 
assemble a simple magic mirror using off-the- 
shelf parts. This can be built in an afternoon and 
is a great way to find out whether you want to take 
it to the next step and get working on something 
a bit bigger. 


Prepare the frame 

To create our magic mirror, we will create 

a ‘sandwich’ of the frame, a piece of observation 
mirror acrylic, and the screen. It’s vital that all 
these are kept as clean as possible during assembly 
as any dust will get trapped and leave an irritating 
mark on your lovely mirror. Unpack the frame, 
remove the mount, and then remove the plastic 
clear sheet. You’ll need to carefully peel back the 
















two protective layers and then replace the clear 
sheet in the frame. This is statically charged and 
will start to attract dust, so lots of cleaning is 
required. Return the mount to the frame. 


Mount the mirror 

The big ‘trick’ of a magic mirror is the use 
of two-way material, also known as ‘observation 
glass’. This material is the same that is used in 
police interview rooms and as privacy screening. 
It’s only semi-reflective, so the output from your 
screen can be seen ‘through’ the glass but it’s 

still effective as a mirror (if a little darker than a 
regular mirror). This material is cheapest when 
bought by the roll, so it’s ideal for custom-build or 
larger mirror projects. Ours is a £5 A5 acrylic sheet. 
Remove the protective sheeting and place in the 
frame, making sure it covers the open area. Secure 
with sticky tape. 





© The big ‘trick’ of a magic 
mirror is the use of two- 
way material, also known 
as ‘observation glass’ @ 


Add the screen 
We’re using the official 7-inch touchscreen 
for this project to make power requirements easier, 
we only need one cable to drive both Raspberry 

Pi and the display. It also happens to be a perfect 
size for this project. The touchscreen needs to be 
carefully placed so it’s in parallel with the frame 
and central. Secure with sticky tape. 





The simplest 
way to mount the 
screen is to use 
gaffer or duct tape 





Secure in place 

The combined weight of a Raspberry Pi 
computer and the touchscreen doesn’t come to 
much, so rather than getting into complicated 
mounting solutions, we will apply generous 
amounts of gaffer (or duct) tape to hold everything 
in place. This is of course a very lo-fi solution — if 
you want to go for something more refined, you 
can consider making use of the mounting points 
on the screen that can be used with horizontal 

or vertical bars to attach to the inner edge of the 
frame. Check for any trapped dust or marks in our 
‘sandwich’ before proceeding. 


Just add Raspberry Pi 

Normally, you would mount a Raspberry 
Pi computer on top of the screen’s PCB on the 
provided standoffs. If you want to mount your 
completed mirror on the wall, this poses a 
problem, as the computer now sits quite a way 
proud of the frame. Your options are: 1) don’t care 
(not advisable), 2) buy a second frame and fix it to 
the original to double its depth, or 3) mount the 
Raspberry Pi computer on the side. We’ve gone 
with option three and it just fits, even with the 
supplied display cable. Make sure you line the 





Raspberry Pi 4 can be 
seaXe)bbanc-lomr-¥ Coyaletcs els 
the screen PCB so itis 
flush with the frame 


back of the screen with 
insulation tape to avoid 
any electrical shorts 
and secure in place with 
a Velcro pad to allow 
for future access to the 
microSD card. 


Check and test 

With a microSD 
card with Raspberry Pi 
OS installed, mount the 
Raspberry Pi 4 into place. 
Check the display ribbon 
cable hasn’t been stretched 
too much and the four jumper 
cables that connect the 
display to the GPIO are in the 
correct position. You should 
now be able to boot and see 
the Raspberry Pi OS boot sequence through the 
display. It will probably look disappointingly dull. 
Don’t worry, we’|l address that in the next tutorial. 
even iiine saree @s dust, secured, and the 
display is working, shut everything down (you may 
need to connect a keyboard and mouse to do this). 


Larger screen? 
Better mount 





We've chosen 
gaffer tape, as 
the official screen 
is very light. 
This would be a 


1K=Ya ale) Ksmle(=toWnne) are) 
‘full-size’ monitor. 
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| BUILD THE ULTIMATE MAGIC MIRROR 


Setting up your 


Check you're looking good and fill your brain with useful 
information with your new frame and MagicMirror? 


You'll Need 


> Magic mirror (see 
previous tutorial) 


Tip! 
Editing JSON 





V_ Aclearer view of 
the screen. You can 
customise all these 
panels and place them 
wherever you like 



















go. Next, we’ll look at how to set up your 

Raspberry Pi computer to run MagicMirror?, 
a dedicated application for creating magic mirror 
displays that takes all the hard work out of the 
software side of this project. MagicMirror? has 
been authored by Michael Teeuw, who created 
the amazing mirror in the beginning of this 
feature. Not only does the software provide a 
plug-in system to control what’s displayed, it 
also configures your Raspberry Pi computer for 
optimal performance as a mirror. That said, there 
are a few things to do, so let’s get started. 


S o far, we’ve got a frame built and ready to 


First boot-up 

In the final step of the previous tutorial, 
we checked that Raspberry Pi would boot 
correctly in its new home. If you haven’t done 
this already, prepare a microSD card with an 
image of Raspberry Pi OS (not the Lite version, 

as we need the desktop). If you have access to a 
second identical Raspberry Pi computer, it might 
be easier to use that, as the display will be easier 








to see, then swap the microSD card when you’re 
done. Go through the first-run wizard that helps 
you configure WiFi and updates all your software 
to the latest version. 


Make access easier 

Every time you want to make a 
configuration change, it’s going to be a nuisance 
to take the mirror down off the wall, locate a 
keyboard, mouse, and possibly monitor to make 
a simple edit. Instead we can use VNC and SSH 
to make life easier. VNC allows us to access 

the desktop remotely via VNC Viewer, which is 
available for many different platforms. SSH is 
similar, but for the command line. To enable both 
of these, open the desktop menu (the raspberry 
icon) and click on Preferences, then Raspberry Pi 
Configuration. When its window appears, click 
the Interfaces tab and ensure VNC and SSH are 
enabled, but don’t close the window just yet. 








Set your host name 

To avoid your magic mirror bumping into 
any other Raspberry Pi computers you may have on 
your network, we strongly recommend setting the 
computer’s host name (the name it is known as on 
the network) to something unique. Again, you can 
set this in the Raspberry Pi Configuration tool. On 
the System tab, choose an appropriate name such 
as ‘magicmirror’ (lower case, no spaces or special 
characters) and click OK. A reboot will be required 
for this to take effect. Once done, you can point 
your VNC Viewer or SSH client to magicmirror.local 
to gain remote access. 








MagicMirror’ defaults 
oe: able) atreteyenae-toy mo) bled ¢ 
and white display which 

works well with the 
reduced visibility 


Tip! Restarting 
MagicMirror? 


hmv cole male \Ucmaate\er 
re merolahirelelgsialoyal 
fol ate lalerommycele mercial 
restart without 
having to reboot 


loNvamays e)ialemaaliceels 
idatomexe)aalaat-vale. 
line: pm2 restart 
MagicMirror 





» 4 


| 
t »kINg Good today! 


Your maker. 


Jad eYoyCorehecye)avneve mre 
magic mirror presents 
unique challenges 


Install MagicMirror? 


app: a web app wrapped up in its own browser. 
Installing it manually is complex, but Michael 

and the team have provided an elegant script that 
automates the entire process. Get to acommand- 
line prompt by using Terminal or an SSH client and 
carefully enter the following command: 


bash -c "$(curl -sL 
https://raw. githubusercontent.com/MichMich/ 
MagicMirror/master/installers/raspberry.sh)" 


(For more detailed instructions, see 
magpi.cc/magicmirror. ) 

The script will now install Node (the 
programming environment that runs 
MagicMirror?), Electron, and the app itself. 


Configuring MagicMirror? 

During installation you’ ll see a lot of 
text fly by the screen, along with a couple of 
warnings that can be safely ignored. You will be 
asked at one point whether you want to install 
and enable pm2. Process Manager 2 (pm2) is an 
application that simplifies the running of Node 
apps (or anything else), starting things at boot or 


Now the fun part. MagicMirror? is an Electron 










© MagicMirror is now Installed 
and you should be able to 
see the display @ 


automatically restarting apps when they crash. 

If you reply ‘yes’, pm2 will start MagicMirror? 
immediately on boot. You will also be asked if you 
want to start the app right away. If you’re eager to 
See il il) ation, say yes. 


Initial configuration 

MagicMirror? is now installed and you 
should be able to see the display on your mirror. 
The installation process has tweaked a lot of 
settings to improve the display quality and has 
disabled things such as screen sleeping. You can 
customise what is displayed on screen and its 
position by having a look at the configuration 
file located at ~/MagicMirror/config/config.js. 
If you’re finding the screen too crowded, you can 
tweak the layout by changing the value of ‘zoom’. 
We found 0.6 worked well for the Raspberry Pi 
touchscreen. We’ ll look into more of these settings 
next time. For now, go and get a hook and put up 
your new fancy magic mirror! 
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Voice Control for 


your Magic Mirror 





Mirror, mirror on the wall, who's the fairest of them all? Whaddayad mean, ‘Alexa'? 


Get the right kit 
Reliable voice recognition requires a good- 
quality microphone. If you want to use services 
such as Alexa, you may want to add an 
amplified speaker too. The easiest 
options are widely available 
USB sound devices, many 
of which are compatible 
with Raspberry Pi. 


P The Snowflake mic is a great choice 





Choose your solution 
MagicMirror?’s plug-in system 
and amazing community means you have a wide 
choice of voice assistants with different purposes 
and capabilities. See magpi.cc/mirrorvoice for 
the current list of modules. 


MMB -awesonme-alexa 





Install your module 

A good starting module is one called 
MMM-awesome-alex. Follow the instructions at 
awesome-alexa.js.org to install the module, then 
add your microphone and speaker to your mirror 
build, being careful not to ‘muffle’ the mic. Now A Old monitors and TVs also make great mirror options, 
your mirror is Alexa-enabled! and you can still easily add voice control to them! 
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CAMERA 
GUIDE 








® Take pictures and shoot video with your 
Raspberry Pi and official camera 


® Set up your HQ Camera or Camera 
Module and control it with precision 


® Fun projects include a wildlife camera 
trap, security camera, and video doorbell 


® 17 chapters packed with essential info 
for Raspberry Pi photography 
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PJ 
Evans 





PJ is a writer, 
tinkerer, and 
enjoys installing 
Raspberry Pi Zero 
computers where 
no-one asked for 
them to be. 


@mrpjevans 


You'll Need 


> One-way mirror film 
magpi.cc/ 
onewayfilm 


>» Monitor with 
bezel removed 
(We used a Spare 
23-inch screen) 


>» Ikea Ribba frames 
to fit monitor 
magpi.cc/ribba2 


> Sample configs 
and compliments,s 
files (optional) 
magpi.cc/mm2git 


Configuring your 
magic MIrror 


Now that we've built gd mini magic mirror, it's time to upscale and 
take gd tour of the powerful software that drives it 


Magic mirror using a semi-transparent 

piece of acrylic and a cheap picture frame. 
Mounting a Raspberry Pi screen behind it allows 
text to appear as if floating in air. We also 
introduced MagicMirror?, an application solely 
designed for creating beautiful displays on your 
mirror. This month we’re going to deep-dive into 
the software and see how we can customise our 
display. First of all, you may notice that we’ve 
given our mirror a bit of an upgrade, using a 
23-inch monitor, semi-transparent film, anda 
larger Ikea Ribba frame. The software build is the 
same, just the hardware is bigger. 


n part one of this guide, we built a simple 


Orientate yourself 

Can a mirror be upside-down? A magic 
mirror can! Most mirrors tend to be portrait, 
whereas screens are normally landscape. 
Normally we could make some changes to 
/boot/config.txt to easily rotate the screen, but 





‘i 


A The rear view shows the mounted monitor and Raspberry 
Pi computer. Removing the monitor's bezel gets the screen 
as close as possible to the surface 
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with Raspberry Pi 4’s fancy new graphics support, 
this is no longer possible. To rotate your display 
90° so it fits your mirror, open a Terminal and 
enter the following: 


sudo nano /etc/xdg/1xsession/LXDE-pi/ 
autostart 


Now add this line to the end of the file: 
@xrandr --output HDMI-1 --rotate right 


Save the file (CTRL+X) and reboot. Your display 
should now be portrait. 


Safety first 


Sadly, MagicMirror? doesn’t (yet) come with 
an easy configuration utility. For now, you will 
need to do some text editing of config.js. Don’t 
worry: as long as you make copies of your files, it’s 
going to be hard to break anything. If MagicMirror? 
refuses to start, just copy the file back. Here’s how 
it works from a Terminal: 





cd ~/MagicMirror/config 
cp config.js config.js.backup 


If anything goes wrong, just copy the config backup 
back and try again: 


cp config.js.backup config.js 
Each time you edit config.js, you’1l need to restart 
MagicMirror? for changes to take effect. To do this 


at any time: 


pm2 restart MagicMirror 





Here's a section of the config file. It's JavaScript code so 
may look a little different if you're used to Python 


Meet the config file 

Your config file controls some of the 
fundamental features of your mirror, as well 
as the various modules. It is formatted ina 
JavaScript file. This is a very well-structured 
language but unforgiving. A misplaced ‘{’ or ‘[’ 
and nothing will work (hence the previous step). 
The config.js.example file is a great way to explore 
without changing anything. You’ ll see how to 
change the ‘zoom’ (text size), units (metric or 
imperial), and whether you want a 24-hour clock 
or not. Most importantly, the ‘modules’ section 
controls which modules (code that gives certain 
functionality) are loaded and where they’re placed. 


The default modules 

MagicMirror? comes with a selection of 
modules pre-installed. Start by tailoring them to 
your specific needs. Find the ‘modules’ section 
in config.js. Within the two square brackets are 
sections contained within curly brackets: { }. Each 
one is a Single module. Each module has different 
requirements but each one requires a ‘module’ line 
like this: 


module: "name-of-module", 


Most also require a ‘position’, which can be 
‘top_bar’, ‘top_left’, ‘lower_third’, and many 
others. This controls where the module is 
displayed on the mirror. If a title is required, then 
‘title’ allows you to change the text of the header. 
Finally ‘config’ will contain information that is 
specific to that module. 


aon | (=¥- Wat lo) ok- Mice laal-m olelikzre! 
Keke [= al-1 mel gaye |Kom= me (-1-] 0) 
Yale] U el a=) oy-(ec- mice) mi dal-maalolalivele 
Taksilo(=¥- Vale Minow ele) /{-1am-s6l 0) 0) Nz 


Tutorial 


This inexpensive adhesive 
semi-transparent film can 
oX-maatolulalx-re mean com aat=) 
reYod av] Meme) ae) Fa Kos) 


Whatever the weather 

Let’s use the weather module 
as an example. Under ‘modules’, find 
‘weatherforecast’. You have the option to 
change the title (maybe ‘Will it rain’) and 
the position of the module on the screen. In 
‘config’ you have three pieces of information 
to complete. To get your own weather forecast, 
eo to openweathermap.org and register fora 
free account. You can then create an API key (a 
secure way of your mirror communicating with 
the service), which you need to specify here in 
‘appid’. Change the name of your location as you 
wish and finally change the location ID to the 
correct one listed in this file: magpi.cc/citylist. 
Restart MagicMirror? and see your local weather! 


Breaking (glass) news 

The default news feed on the mirror comes 
from The New York Times, which may not be your 
cup of tea. The ‘newsfeed’ module works with any 
RSS feed, of which there are millions to choose 





Top Tip 
Learn JSON 


If you're serious 
about configuring 
MagicMirror?, 
knowing the JSON 
data format is 
essential. Have a 
look at json.org. 
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TopTip @ 


Back it all up 


If you're editing 

a module or 
config file, it costs 
nothing to create 
a copy - then if 
it all goes wrong, 
you can try again. 





> It may be easier to 
configure your screen 
before mounting it in 
the mirror 


from (and you can have multiple newsfeeds if you 
wish). Let’s change the newsfeed to the BBC. Find 
the module ‘newsfeed’ and you’|] see under ‘config 
the ‘feeds’. This is surrounded with square brackets 
[ ], which means we can have multiple entries. 
Change ‘New York Times’ to ‘BBC News’ and the 
‘url’ to ‘http://feeds.bbci.co.uk/news/rss.xml’. 
Restart MagicMirror? and now you’re getting the 
headlines from the UK. 


d 


07 Vampire mode (no reflection) 

By now you may be finding it a little 
frustrating if you’ve already put up your mirror. 
With a bit of reconfiguration, you can access the 
mirror display using a web browser and work on it 
from your desktop. Edit config.js and have a look 
at the first few lines under ‘config’. These control 
access to the display. It’s locked down by default 
(which is good), but we can allow other computers 
access. Change these following lines as shown: 

address: "", 
ipWhitelist: [] 


This allows any IP address on your network 
to access the server. You’1l need to restart 
MagicMirror? for changes to take effect. Now 
you should be able to see your display at 
http://<your mirror’s IP address>:8080. 


= 
Mas 
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Client and server mode 
The reason we can So easily see the display 
in a web browser is that MagicMirror? is split in to 
two parts: the client, the software that displays 
the screen; and the server, which generates the 
content. This clever split allows you to generate the 
content from a separate computer on the network, 
which is handy if you want to do something really 
intensive. It also allows you to have multiple 
mirrors that all show the same display, which 
makes rolling out changes really easy. 

To start an installation of MagicMirror? without a 
display (server): 





node serveronly 


To create a client that gets its content from 
the server: 


node clientonly --address <ip of server> 
--port 8080 


M |n the centre of the screen, 
there are ‘compliments’ 
rotating every few seconds. 
You can change these 


Editing modules 

Let’s have a look at modifying existing 
modules. You’|l have seen in the centre of the 
screen, there are ‘compliments’ rotating every few 
seconds. You can change these in config.js, but 
let’s look in the actual code so we can get a feel of 
how things are arranged. In Terminal, navigate to 
where the default modules are installed: 


cd ~/MagicMirror/modules/default 
If you do an Is to get a directory listing, you’ ll be 
able to tell what’s available. We’re interested in 
the ‘compliments’ module: 

cd compliments 
Now edit the file: 


nano compliments.js 


Look at the various text strings and change 
them to whatever you like. Save the file and 





A There are many, many modules available for all kinds of 
uses. This one shows you a daily Pokemon! 


restart MagicMirror? to see your new messages. 
A sample compliments.js file can be seen at 
magpi.cc/mm2compliments. 


More modules 

Great news: you are not restricted to 
the default modules. There are hundreds of 
community-built modules that are free to 
download and install. They cover all kinds of 
useful information, including stock prices, local 
transportation, prayer guides, and even how your 
local Minecraft server is holding up. Luckily, a 
directory of MagicMirror? modules is maintained 


on the main site’s wiki: magpi.cc/mirrormodules. 


Most modules will require some configuration, 
so make sure you look at the README file and 
follow the instructions carefully. There’s no 
limit to how many modules you can have, bar the 
positions available on the screen. 


Installing modules 

Sadly, we don’t have a nice package 
manager for MagicMirror’, so installing modules 
tends to involve using Git to fetch the code. For an 
example, we’re going to install ‘Daily Pokemon’. 
From the Terminal, we’ll go to the modules 
directory, then get the code from GitHub. 


cd ~/MagicMirror/modules 

git clone https://github.com/NolanKingdon/ 
MMM-DailyPokemon 

cd MMM-DailyPokemon 

npm install 


The final command gets all the libraries that the 
module needs to run. Once completed, edit the 
config file: 
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DOWNLOAD 





Figure 1 


» Language: JSON 


THE FULL CODE: 


vy) magpi.cc/mm2config 






QQ@1. modules: [ 





Q02. { 

003. module: "MMM-DailyPokemon", 
004. position: "top center", 
Q05. config: { 

006. updateInterval: 600000, 
007. minPoke: 4, 

008. maxPoke: 151, 

Q09. grayscale: true, 

Q10. showType: true, 

Q11. language: "en", 

Q12. genera: true, 

Q13. gbaMode: true, 

Q14. nameSize: 26 

Q15. } 

Q16. }5 


nano ~/MagicMirror/config.js 


Create a new line after modules: [ and add the 
code from the Figure 1 listing (or use the download 
link for the full, edited config.js file). Make sure 
you end with a comma. Restart MagicMirror? and 
admire your daily Pokémon. 


More modules 

As we’ve already said, there’s a dizzying 
array of modules to choose from, and you can 
even write your own. If you’re in the mood for 
customising, here are a few of our favourites. 
You can find all of them, along with installation 
instructions at magpi.cc/mirrormodules. 


magpi.cc/mmmstocks 
Every information screen needs a stock 
ticker, right? 


magpi.cc/mmmwiki 
Up your knowledge as you get ready to leave the 
house with these random snippets from Wikipedia. 


magpi.cc/mmmukrail 

Is your train going to be on time? If you’re in the 
UK, this module will let you know. Many other 
countries have equivalent modules too. 
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Evans 





PJ is a writer, 
tinkerer, and 
enjoys installing 
Raspberry Pi Zero 
computers where 
no-one asked for 
them to be. 


@mrpjevans 


You'll Need 


>» Amagic mirror (see 
parts 01 and 02) 


> Raspberry Pi 
Camera Module 
magpi.cc/camera 


> 3D-printed case 
(optional) 
magpi.cc/ 
cameracase 


Facial recognition 
with a magic mirror 


Mirror, mirror on the wall, who Is the fairest of them all? 
Decide with a smart face-recognising magic mirror 


and configured a magic mirror using the 

impressive MagicMirror? software. Now 
we have our mirror constructed and configured 
to our liking, it’s time to go to the next level of 
personalisation. Wouldn’t it be amazing if the 
mirror’s display could be customised based on 
the person standing in front of ite Wouldn’t it be 
even better if that could happen by the mirror 
recognising the person standing there? Turns out, 
that’s well within the capabilities of a Raspberry 
Pi computer. We’ build multiple mirror 
configurations that appear when the right person 
is recognised. 


n the previous two instalments, we’ve built 


Magic up a mirror 

This project is an enhancement to 

the tutorials we covered in the previous two 
instalments (p154 and p162). That means that 
you’ re going to need a magic mirror before we go 








A The official Raspberry Pi Camera Module is a 
perfect choice for this project 
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any further. To recap, we made a ‘budget’ version 
using the Raspberry Pi official touchscreen, a small 
Ikea frame, and a generous amount of gaffer tape. 
Basic, but surprisingly functional. Having given 

it all a bit of a polish (software speaking) in the 
second article, we’ll be building upon our current 
mirror. If you’ve gone your own way, that’s great: 
the instructions will be roughly the same. 


Casing the camera 

If we’re going to add the ability to customise 
the display based on who is standing in front of it, 
then we’ re going to need some vision. The easiest 
choice would be the official Raspberry Pi Camera 
Module. It’s small, powerful, and easy to connect. 
How you want to mount the camera to your project 
is entirely your call. Here, we’ve 3D-printed a 
small case for the module so it fits in with its 
surroundings. The small case matches the frame 
and was easily secured with some strong tape. The 
more ambitious of you may consider mounting a 
camera directly in the frame. 


Attach and enable the camera 
Whatever camera solution you decide to 
use, you’ ll need to connect it to your Raspberry 
Pi computer. If you’re using a Camera Module, 
attach the ribbon cable to the main board following 
the instructions here: magpi.cc/picamera. 

Once connected to the board, configure it by 
running sudo raspi-config from the command 
line and enabling the camera under ‘Interfacing 
Options’. If you’ve gone with a USB webcam, see 
the instructions provided with it and check for 
Raspberry Pi compatibility before purchasing. 








Bi al=me [sje] t-\\mer- lam ol=) 
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Rotate the screen 

The positioning of the camera may make you 
reconsider which way around you would like the 
mirror. If using the Camera Module, the provided 
ribbon cable requires that the mirror is portrait with 
the Raspberry Pi computer at the top. Changes in 
eraphics systems with the move to Raspberry Pi 4 
and Raspberry Pi OS mean the easiest way to set 

the screen orientation is within the desktop itself. 
Stop the MagicMirror? software by entering this at 
the command line: pm2 stop MagicMirror. Then, in 
the desktop environment, go to the menu, select 
‘Preferences’, then ‘Screen Configuration’. Right- 
click ‘DSI-1’ and select ‘orientation’, then ‘right’. 
Now click the ‘tick’ to save. 





Install OpenCV and more 

Now we’re ready to get to work. To be 
able to recognise faces, we need some artificial 
intelligence. The amazing OpenCV software 
is not only free of charge but also superb at 
recognising objects, including individual human 
faces. Understandably, it’s a monster of an 
application, so we recommend a Raspberry Pi 4 
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The official Raspberry 
Pi Camera Module 
sits above the frame 


Screen rotation 


No luck with 
face recognition? 
Train, train, and 
train again. The 
more data, the 
more accurate 
the result. 





with at least 2GB of memory. You can run it on 
older models, but it’s a lot more complicated. See 
the excellent pyimagesearch.com resource for 
more information. To install, run the following 
from the command line: 


sudo apt -y update && sudo apt -y upgrade 
sudo apt install libopencv-dev python3-opencv 


Tool up 

To be able to accurately identify someone’s 
face, we need to train our magic mirror. Using 
machine learning systems, we’ll take photos of the 
mirror’s users and create mathematical models of 
those faces so the mirror can recognise them in 
future. To do this, we’ll download some tools. Run 
the following commands: 


cd ~ 
git clone https://github.com/mrpjevans/MMM- 
Facial-Recognition-Tools.git 
(If you get an error, run sudo apt install git, 


then try again.) 
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TopTip @& 


PylmageSearch 


Want to know 
more about image 
processing and 
recognition using 
Python? There's 
no better resource 
than Adrian 
Rosebrock’'s 
pyimagesearch. 
com. 





We now have a collection of tools to help train 
our mirror to the various faces it may encounter. 


07 Training time 
Now it’s time to train our mirror. Run the 
following commands: 


cd ~/MMM-Facial-Recognition-Tools 
python3 capture.py 


Choose whether to capture live photos from your 
webcam, or train from JPEG photos (you’ ll need 
to upload them in advance). You’|l be asked for 
your name. Keep it simple. Your author chose 
‘pj’, avoiding capitalisation, spaces, and special 
characters. You should now see your face on the 
mirror’s display. Line up your face with how you 
think you’ ll be looking at the mirror (‘in situ’ is 
best) and press ENTER to take a snapshot of your 
face. Repeat this at least ten times before pressing 
CTRL+C to stop. 

Finally, run python3 train.py to convert the 
images into mathematical data. When prompted 
for an algorithm, select LBPHF. 


Testing time 

To verify that the training worked, a testing 
Script is provided. From the same directory, run 
these commands: 


export FACE _ALGORITHM=1 
export FACE_USERS=pj 
python3 facerecognition.py 


(Replace ‘pj’ with the name you chose. ) 
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After the script has started up, have a look 
into the camera at the same angle you took the 
training photos. If all is well, you’ll see reports 
that your face has been identified! This means 
the mathematical model has matched you with 
what it is currently seeing. If you don’t get 
good results, try retraining or changing the 
lighting. Repeat the process until you’re getting 
satisfactory results. 


Install the module 

Now we have our machine-learnt data, 
we can go ahead and install the actual facial 
recognition module. To do this, we need to install 
some code in the MagicMirror? modules directory: 


cd ~/MagicMirror/modules 
git clone https://github.com/mrpjevans/MMM- 
Facial-Recognition 


This installs all the files we need to add the module 
into the system. To complete the installation, we 
need to add dependencies: 


cd MMM-Facial-Recognition 
npm install 


After a short time, all the files we need to run the 
module will be installed. 

Finally, make a copy of the training data from 
Step 07 into the modules directory: 


cp ~/MMM-Facial-Recognition-Tools/training. 
xml ~/MagicMirror/modules/MMM-Facial- 
Recognition/ 


Configure the module 

Now we’re all ready to add the module to 
our magic mirror. Just like last month’s tutorial, 
we need to edit the /config/config.js file to add 

our module in. This is in JSON (JavaScript object 
notation) format, which is unforgiving of errors, so 
add things in carefully and if in doubt, make a copy 
of the file first so you can also ‘roll back’ should it 
be needed. 





nano ~/MagicMirror/config/config.js 


Scroll down the file until you see the ‘modules’ 
section. There will be a series of entries grouped by 


{ and }, all of them grouped in [ and J. You need to 
add the list1.js listing printed here into the [ and ] 
eroup. Each group of { and } needs to separated by 
a comma (except for the final one). Don’t save the 
file just yet. 


fm After a few seconds, the 
system should restart 
and the ‘default’ modules 
gre shown 


Customise the modules 

Have a look at the config section you’ve just 
added. Where it says ‘users’, make sure the names 
in the following square brackets match the ones 
you have trained for. Ours was ‘pj’ so it should 
read [‘pj’]. If you trained multiple people, separate 
them with commas: [‘alice’, ‘bob’]. 

Now, for each module you want to customise per 
person, add an extra parameter of ‘classes’. This is 
a string with multiple entries separated by spaces. 
Add ‘default’ for always shown, ‘everyone’ for 
every recognised face, and specific names if that 
module is only to shown for that person. See the 
list2.js listing for an example. 


Try it! 
Now it’s finally time to try out your mirror. 
Restart MagicMirror? by running this command: 


pm2 restart MagicMirror 


After a few seconds, the system should restart and 
the ‘default’ modules are shown. Have a look into 
the camera as you did for training and see if your 
modules appear. After a second or two, the mirror 
should refresh with your choice of display. 

If you have any problems, use SSH to connect to 
your mirror and run pm2 logs. This will show you 
a live update of what’s going on. Typically, any 
problems will be either not enough training or poor 
lighting. Just retrain by following the earlier steps 
and have another go. Soon you’!] have a cool mirror 
that is unique to each of its visitors. 


Thanks to Paul-Vincent Roll, author of the original 
MMM-Facial-Recognition module. 
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list1Js 


» Language: JSON 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 


module: 'MMM-Facial-Recognition', 
config: { 
// Array with usernames (copy and paste 
from training script) 
users: ['pj'] 


list2,js 


» Language: JSON 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
9e9. 
010. 
Q11. 
012. 
013. 
014. 
Q15. 
016. 
Q17. 
018. 
919. 
020. 
Q21. 
Q22. 
Q23. 
Q24. 
Q25. 
026. 
Q27. 


028. 
Q29. 
030. 
Q31. 
Q32. 
Q33. 


var config = { 


modules: [ 
{ 
module: "clock", 
position: "top left", 
Classes: 'default' 
}s 
1 
module: "compliments", 
position: "“lower_third", 
config: { 
compliments: { 
anytime: [ 
"Hey, PJ!" 
] 
} 
}s 
classes: 'pj' 
}s 
{ 


module: 'MMM-Facial-Recognition', 
config: { 
// Array with usernames (copy 
and paste from training script) 
users: ['pj'] 


}3 


The Official Raspberry Pi Handbook 2021 | 169 


SE Juicrial | CREATE MODULES FOR YOUR MAGIC MIRROR 





Evans 





PJ is a writer 

and software 
engineer. His 
Smol Robot would 
probably be 
fuelled by coffee 
and mild panic. 


@mrpjevans 


You'll Need 


> Amagic 
mirror running 
MagicMirror? 


> JavaScript code 
editor such as 
Visual Studio Code 
magpi.cc/ 
visualstudio 


> 3D-printed case 
(optional) 


Create modules for 
your magic murror 


Can't find the perfect add-on for your magic mirror? Why not make your own? 
In this tutorial we'll create a fun module for MagicMirror? 


Ss we’ve covered in the previous magic 
mirror tutorials, there are hundreds of 
modules out there to display custom 
information on your MagicMirror? display, 
including stock prices, the weather, or even 
your favourite Pokémon. So what to do when you 
can’t find what you’re looking fore Write your own 
of course! The module system in MagicMirror? 

lets anyone add custom code to their mirror 

with powerful control over the display. You can 
even interact with other modules. As a simple 
introduction, we’re going to build a simple module 
that displays the latest cute little robot from the 
@smolrobots Twitter account. 





A, 


Set up your mirror 

To make sure we don’t get confused with 
anything else, we recommend removing everything 
from your display except the clock — which we’ ll use 
to check that everything is working, as MagicMirror? 
does its best to Keep calm and carry on if a module 
has a problem. Logging in as the ‘pi’ user, first 
make a copy of the config file: 





cp ~/MagicMirror/config/config.js 
~/MagicMirror/config/config-backup.js 


Now have a look at the file: 

nano ~/MagicMirror/config/config.js 
You will see JSON-formatted text. Find the 
‘modules’ section and remove everything so it looks 


like this: 


modules: [ 
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module: "clock", 
position: "top left" 


] 


Press CTRL+X followed by Y to save. Now restart the 
software to make sure everything has taken effect: 


pm2 restart MagicMirror 


Choose how to code 

If you can’t access your mirror witha 
display and keyboard (as it’s busy being a magic 
mirror), you'll need to find a way of coding on 
your Raspberry Pi. You can SSH in and use nano 
or vi if you like. If you have a capable SFTP client, 
you can also use this to access files in your home 
directory and then work on them on your ‘regular’ 
computer using a JavaScript code editor such as 
Visual Studio Code. MagicMirror? is written using 
JavaScript, so Python editors such as Thonny 
cannot be used. 


How to create a module 

Each MagicMirror? module is a JavaScript 
file and the code inside is called a class. The class 
has several built-in methods (like functions) that 
we don’t see and the server calls them to get the 
information it needs to create the display. What 
we need to do is replace (or ‘override’) one or more 
of the methods to get the output we want. You’11 
find all modules in the ~/MagicMirror/modules 
directory. The built-in displays such as the clock 
are, unsurprisingly, in ‘default’. Create a folder 
alongside default called MMM-Hello-World 








A Thomas Heasman-Hunt's Smol Robots are a favourite in the 
Raspberry Pi community. He even designed the Pi Wars robot! 





(MMM = Magic Mirror Module). Inside the folder, 
create a blank file called MMM-Hello-World.js. 


Hello World 

As you’ve probably guessed, we’re 
going to create a simple ‘Hello World’ module. 
Enter the code in listing1.js (or download it from 
magpi.cc/mmA4git) using your code editor. Use 
nano if you wish, but a proper editor will do all 
kinds of highlighting and syntax checking which 
makes it much easier to fix typos and bugs. The code 
overrides the ‘getDom’ method, which is called 
when the server wants us to return some content. 
Here we create a HTML element, ‘div’, and add the 
text to it that is defined in the defaults section. We 
then return that HTML object to the server to place 
on the display. 


MA proper editor will do all 
kinds of highlighting and 
syntax checking 

Try it! 
To actually get our message to display on 


the screen, we have to ask MagicMirror? to load the 
module. Let’s go back to the config file: 


nano ~/MagicMirror/config/config.js 


Find the ‘modules’ block, as we did previously, and 
modify if so it looks like this: 


modules: [ 


module: "clock", 
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We're going to display the 
latest small robot, but we'll 
have to invert the image first 


position: "top left" 


}5 

{ 
module: "MMM-Hello-World", 
position: “lower_third" 

} 


] 


Save the file and restart MagicMirror? as in the 
earlier step. You should now see ‘Hello World!’ 
displayed at the bottom of the mirror. You’ve 
created your first module! You can also specify a 
custom message in config.js like this: 


{ 
module: "MMM-Hello-World", 
position: “lower_third", 
config: { 
text: "MagPi rocks!" 
} 
} 


This overrides anything in ‘defaults’ in your module. 





WY A at=lame(=\V/-1 Ce) e)l ale) 
modules, keep the 

fot KoYoi @=Jar-lo)(=re Be mZel6| 
can quickly see if 


e)gal=i4allale Matemageyd=ia) 


TopTip @ 


What's 
this Dom 
business? 


The ‘Dom’ in 
‘getDom’ and 
‘updateDom’ 
refers to the 
Document Object 
Model (DOM), 
which is how 
the browser 
structures the 
webpage you 
are viewing. 
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TopTip @& 


Learn 
JavaScript 





New to 
JavaScript? 
Read our guide 
to learning 

this powerful 
language in The 
MagPi issue 93 
(magpi.cc/9g3). 


Create the Smol Robots module 
Let’s get a bit more advanced. Thomas 
Heasman-Hunt draws cute little robots a few times 
a week and posts them on Twitter. Wouldn’t it be 
nice to be greeted by a little robot in the morning 
when we looked in the mirror? Luckily, Tom Panton 
has created an API that lets us fetch the very latest 
robot, so we can use that to get the robot image and 
display it. Create a directory under modules: 





mkdir ~/MagicMirror/modules/MMM-Smol-Robots 
Now create a matching JavaScript file: 


touch ~/MagicMirror/modules/MMM-Smol-Robots/ 
MMM-Smol-Robots.js 


07 Accessing the API 

Open the file you created in the previous 
step in your favourite editor and enter the code in 
listing2.js. This is JavaScript, so be careful with 
the curly brackets and semicolons. Again, we’re 
overriding ‘getDom’ but this time we’re using the 
built-in ‘fetch’ function to get information from 
the Smol Robots API. If you want to see what we’re 
getting, enter the following URL in a web browser: 


https://mrpjevans.com/smol/api/latest/1 


What is returned is a block of JSON-formatted data 
about the latest robot. You should be able to find 


listing1.Js 


>» Language: JavaScript 


Q@@1. Module.register("MMM-Hello-World", { 


002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 


// Default module config. 
defaults: { 
text: "Hello World!" 


hs 


// Override dom generator. 
getDom: function() { 
var wrapper = document. 


createElement ("div"); 


910. 
Q11. 
Q12. 
Q13. }); 


wrapper.innerHTML = this.config.text; 
return wrapper; 
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its name, description and, most importantly, the 
location of the image file. 


Get a robot! 


Save your code and edit the config file again 
to replace the ‘Hello world’ module. Your config 
file’s modules block should look like this: 


modules: [ 

{ 
module: "clock", 
position: "top left" 

}s 

{ 
module: "MMM-Smol-Robots", 
position: “lower_third" 

} 


Restart MagicMirror? as before. Within a few 
seconds, a delightful robot will grace your screen. 
The code has accessed the API, located the URL to 
the image, and created a block of HTML that calls 
the image in at a reasonable size (feel free to tweak 
this). The HTML object generated is then returned 
to the server, which places it in the desired position. 


M™ This is JavaScript, so 
be careful with the curly 
Drackets and semicolons @ 


Let’s be negative 

But wait! There’s a problem. Smol Robots 
are always black ink on white, which doesn’t work 
well with our mirror. Sure, if you’re happy with it 
displayed this way, that’s up to you, but if we could 
invert the image, it would look much better. 

Thankfully, the powerful world of CSS 

(Cascading Style Sheets) can do just that. Find the 
line that reads: 


img.style = "width: 300px;"; 
Now change it to read like this: 


img.style = "width: 300px; filter: 
invert(1);"5 


‘Filter’ is a powerful style rule that can perform all 
manner of tricks on images. In this case, we ask it to 


invert all the colours. Save the file and reload your 
magic mirror. Ah, that’s much nicer: our robot now 
seems to float on the screen. 


More robots! 

Our robot is displaying, but what about 
when a new robot is unleashed from the Smol 
Robots laboratory? Typically this happens a few 
times a week, so a daily check should suffice. We 
can do this by setting up a timer function to refresh 
the module. Right after the ‘defaults’ block, add 
listing3.js. This override is called once when the 
server is started. We use it to set up a timer that will 
call updateDom (which in turn triggers getDom) 
once a day. You can change this value in the defaults 
section or specifying a value in config.js. Now your 
robots will appear like magic. 


Publishing modules 

If you’ve got an idea for a module, and 
now have enough knowledge to get started, 
great! When it’s done, why not share it with the 
community? The main page for third-party modules 
is Magpi.cc/mirrormodules. We recommend 
hosting your module on a Service like GitHub. Then 
you can edit this webpage and add your module 
to the list. Make sure to read (and follow) the 
euidelines and be prepared to offer support. 


Experiment 

This has been only a brief introduction 
to the world of MagicMirror? modules. There is a 
wealth of information in the official documentation 
(magpi.cc/mm2doc), where you can learn about 
the other tricks possible. As well as communicating 
with the outside world, as we have done here, you 
can communicate with other modules. The weather 
module can tell you the temperature, or alert you 
when there’s new data. The calendar broadcasts an 
alert when it’s time for an appointment and you can 
react to that. We hope you get planning and would 
love to see the results. Wl 


Many thanks to Thomas Heasman-Hunt for letting us borrow their 
robots. Check out their latest book at magpi.cc/smallrobotsbook. 
Also, thank-you to Tom Panton for provision of the API. 
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listing2.js 


» Language: JavaScript 


001. 
002. 
003. 
004. 
905. 
006. 
007. 
008. 
909. 
010. 
011. 
O12, 
O13; 
014. 
Q15. 
016. 
017. 
018. 
919. 
920. 
Q21. 
Q22. 
Q23. 
Q24. 
O25; 
Q26. 
O27. 
028. 
O29. 
930. 
O33 
O32: 
933. 
934. 
Q35. 
936. 
O37. 


Module.register("MMM-Smol-Robots", { 
// Default module config. 
defaults: { 


hs 


feed: "https://mrpjevans.com/smol/api/latest/1", 
updateInterval: 3600 * 24, 
fadeSpeed: 4000 


// Override dom generator. 
getDom: async function() { 


})s 


Log. info("Refreshing Smol Robot") ; 


// Get the latest Smol Robot 

const response = await fetch(this.config. feed) ; 
const bots = await response.json(); 

const bot = bots[@]; 


// Wrap the image URL in an IMG element 
const img = document.createElement("img") ; 
img.src = bot.image.url; 

img.style = "width: 30@@px;"; 


// Add title and description 

const title = document.createElement ("div") ; 
title.innerHTML = bot.name. full; 

const description = document.createElement("small") ; 
description.innerHTML = bot.description; 


// Create a wrapper element and return 

const wrapper = document.createElement("div") ; 
wrapper.appendChild(img) ; 
wrapper.appendChild(title) ; 
wrapper.appendChild(description) ; 

return wrapper; 


listing3,js 


>» Language: JavaScript 


001. 
002. 
003. 
004. 
905. 
006. 
007. 
008. 
909. 
010. 


start: function() { 


Log.info("Starting module: 


+ this.name) ; 


var self = this; 


// Schedule update timer. 
setInterval(function() { 


self .updateDom(self.config.fadeSpeed) ; 


}, this.config.updateInterval) ; 


The Official Raspberry Pi Handbook 2021 | 173 


aspberry Pi is an incredible computer, 


and we love using ours to experiment CHECK QUT QUR QUICKSTART 
like some sort of eighties movie LED and GUIDE FOR COMPLETE STEP- 
robot scientist. However, like everything, it’s not BY-STEP INSTRUCTIONS 


flawless. Same with us Raspberry Pi users. Due to 
the unpredictable nature of mixing machine and 
human nature, sometimes things go a bit wrong. 

This is where this article comes in. Everyone 
needs to learn how to correctly solve their 
computing issues, and through this easy-to- 
follow guide we’|ll show you some common fixes, 
starting from the basics, all the way up to more 
advanced issues. Put away the soldering iron and 
get ready to read. 


FRR fee c 


EDP Peps 


FF 





As syncs 


Cables 
Make sure that everything is properly 


plugged in to your Raspberry Pi — this includes 
power, HDMI, USB, Ethernet, audio, etc. If in 
doubt, give it a gentle jiggle in the slot and firmly 
push it in. Double-check the other end of the 


cables as well. 


microSD card 
Make sure a microSD card is inserted 


properly into the underside of your Raspberry 
Pi. Again, push it firmly in — if needed, take your 
Raspberry Pi out of its case before doing this. 


Monitor 
Connect to a monitor or display and turn it 


on before booting your Raspberry Pi - sometimes a 
Raspberry Pi won’t output a video signal if there’s 


nowhere for it to output to. 
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EVERYONE'S A NEWBIE AT SOME POINT, HERE ARE SOME 
COMMON PROBLEMS YOU MAY NEED TO LEARN ABOUT 


A telltale sign of a Raspberry Pi not 

having enough power is a lightning bolt 
symbol appearing in the corner of the screen, or 
a peripheral/accessory not working properly. 
You need to make sure you have a powerful 
enough supply for your Raspberry Pi — this 
means a rating of 5 V 2.5A for a Raspberry Pi 3B+ 
and below, or 5 V 3A for a Raspberry Pi 4. 





Using a Raspberry Pi Camera Module 

is usually straightforward. However, if 
it won’t respond to commands then it may 
likely be a couple of things. First of all, check 
it’s plugged in the correct way. Only one side 
of the ribbon cable has silver connectors and 
they need to line up with the connectors in the 
Camera slot. Secondly, you may need to enable 
the Camera in the Raspberry Pi Configuration 
tool - under the Interfaces tab. 
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Change Password 


If you’ve turned on your Raspberry Pi and 

are greeted with a command line instead 
of the desktop, it may have been told to boot to 
the command line instead. Run the command 
startx to boot into the desktop, then go to 
Raspberry Pi Configuration to change the option 
to boot ‘To Desktop’ - under the System tab. 


Once upon a time, you were pretty easily 

able to transfer a working microSD card 
from one Raspberry Pi to another. 
Unfortunately, that doesn’t always work any 
more, and you’ll be forced to reinstall Raspberry 
Pi OS (or your preferred OS) onto the card - see 
page 11. Make sure to back up any important 
files to a USB stick or the cloud before doing so, 
though — it will completely wipe the card. 


Wireless LAN having issues° Ethernet causing 

a fuss® Sometimes you just need to reboot your 
Raspberry Pi. If that doesn’t work, head over to our 
‘network fixes’ section on page 34. 


If you have an issue that isn't covered 
here, then the best place to go is the 
Raspberry Pi Forum: rpf.io/forums. It’s 
full of amazing and friendly people who 
have helped folks with many Raspberry 
Pi problems. Search for your problem 
first; then, if you can't find it, start a 


thread in the Troubleshooting section. If a piece of software isn’t running properly, 


then it may require an update. Open up the 
Terminal and type the following two lines to update 
all your software: 


sudo apt update 
sudo apt upgrade 


If you’re programming a button or LED or any 
other component connect to Raspberry Pi’s 
GPIO, you need to make sure to reference the correct 
GPIO pin. Double-check your code and wire against 
the image below. If they’re correct, you 
may just need to move it to a different 
available pin. 


|| 
} 
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a 
ea 
J 
— 
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ce 
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RASPBERRY PI NOT TURNING ON PROPERLY’ 
HERE ARE SOME THINGS TO LOOK OUT FOR 


THE ACT LED ALSO HAS SPECIFIC 
PATTERNS FOR SPECIFIC FAULTS. FIND 
QUT WHAT THEY ARE HERE: 


On the opposite end of the USB and 

Ethernet ports on a Raspberry Pi, you’ ll 
notice there are two little LEDs. The red one 
shows if there’s power, while the green 


one is the ACT light. If the ACT light - 
: 
.) 
WN. 


is blinking erratically during 
* 











bootup, it means it’s reading 
Eneimicros Discard Linear 
it’s not blinking at 

all, it means it can’t 
read the microSD 

card and so you may 
need to use anew 

one or reinstall your 

OS see Paget 


vy % 


= 
a” ‘ 


74 









Very simply, this means 

not enough or no power 
is getting to your Raspberry Pi. If 
the power supply drops below 4.65V, 
this red LED will not light up. You may 
need to check your power supply for faults, 
including a broken connector, and replace it. 

If you’ve checked your power supply and it’s 
all working (on another device), if the problem 
Raspberry Pi isn’t turning on then it’s likely the 
board is broken. 

Note: the first-generation Raspberry Pi 
model has a polyfuse — if this gets blown, it can 
reset/repair itself, but you may have to wait a 
few days for this to happen. 


Need more advanced boot solutions? 
Check the documentation for Raspberry 
Pi on the Raspberry Pi website here: 
magpi.cc/bootdocs 





Raspberry Pi can 
output a composite video 
signal via the 3.5mm headphone 
jack. If you’re using an older pre-installed 
NOOBS card, or still have some lying around, 

it’s good to know that holding the number 3 key 

on aconnected keyboard will force it to output via 
the composite output if that’s what you’re using. If 
you’re in the US or another NTSC country, hold 

the 4 key instead. 


While uncommon, microSD cards can 

sometimes become corrupted while being used 
in a Raspberry Pi. Unfortunately, there’s no solution 
to this other than getting a 
new microSD card, so make 
sure to back up your card 
regularly. You can do this by 
Saving any important files, or 
even by making an image from 
your current card. We havea 
video on how to do this here: 
magpi.cc/backupvid 
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Raspberry Pi 


CAN'T CONNECT TO YOUR LAN? NO INTERNET’? 
HERE ARE SOME THINGS YOU CAN DO 


¥ re ») 11:27 If you don’t have a wired connection 


handy, you can add settings for your 
wireless network onto the boot folder of a 
oo : 
¥ ve) a )) 11:27 Raspberry Pi microSD card. Create a file there 
called wpa_supplicant.conf and add your 
network details like so: 


¥ Tl q)) 11:27 ctrl_interface=DIR=/var/run/wpa_ 


supplicant GROUP=netdev 
update_config=1 


The network symbols in Raspberry Pi OS country=<Insert country code here> 
are pretty easy to read, and there are three 
with which you should be familiar. The first network={ 
symbol is two grey lines with a red X on opposite ssid="<Name of your WiFi>" 
ends — this denotes no network connection of psk="<Password for your WiFi>" 
any kind. Two blue arrows facing in opposite } 


directions means you have a wired connection 
working, while the circle with waves emanating 
from it means you have a wireless connection. — 


Re 






a 


Different Raspberry Pi models have 

different connection speeds, especially 
on Ethernet connections. Raspberry Pi 3 and 
below max out at about 100Mbps as they use a 
100MB adapter over USB. Raspberry Pi 3B+ is 
roughly 280Mbps, as it has a Gigabit Ethernet 
connection on a USB 2 line. Raspberry Pi 4, 
however, is a full gigabit. If you’re having 
Speed issues, make sure your router or switch 
supports up to the speeds you’re expecting, and 
test with different Ethernet cables. 


= Wiifi Analyzer 
146 


There are a lot of things 

that can interfere with 
your wireless reception in 
your home. Distance from 
your router, interference from 
neighbours, walls, and even 
just too many people on the 
same channel. We like to use 
apps like Wifi Analyzer to test 
locations around our home 
to find out the best spots to 
place wireless devices such as a 
Raspberry Pi. 


Many security precautions have been 
implemented in the last couple of years to 
make sure Raspberry Pi OS and Raspberry Pi are more 

secure — this includes making sure people change 
the password on their Raspberry Pi, and Keeping 
SSH off. You can turn it on from the Interfaces tab 
in Raspberry Pi Configuration — or, if you’re using 
a headless Raspberry Pi, simple place an empty file 
called ssh in the boot folder of the microSD card. 


Raspberry Pi Zero does not include an Ethernet 

port. However, if you need to use a wired 
connection, you can always use a USB Ethernet 
dongle. It may not be as speedy as other Raspberry Pi 
models, but it will do the job. 


A workaround for a lot of people wanting a 

portable, network connected computer is to put 
it into ‘gadget’ or USB boot mode. If you’re having 
trouble and want to deactivate it, either flash the 
microSD card (see page 11) or head to the usbboot 
documentation to fix your setup: magpi.cc/usbboot 








Raspberry Pi 3/3B+ and 4 support 
network booting, and Raspberry Pi 3B+ 
and 4 even support Power over Ethernet 
with the PoE HAT. 

These are advanced methods and 
have some issues you might come 
across, such as DHCP timing out, ARP 
check failing, and others. For full details 
on how to set it up and troubleshoot, we 
suggest heading to the network booting 
documentation here: magpi.cc/netboot 
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186 MARS. Rover 


Explore new territory with this sophisticated 
six-wheeled robot kit 


188 SmartiPi Touch 2 
Smart-looking case for the discerning 
touchscreen user 


189° Enviro 


Environment-sensing board with a mini LCD screen 


190 Argon Neo &Fan HAT 


Stylish protective case with optional fan add-on 


192 RedBoard+ 


Feature-packed robotics board with plenty of power 


194 Unicorn HAT Mini 
Versatile mini RGB LED matrix with bright pixels 


195 HAT Hacker HAT 


Two sets of 40 GPIO pins to connect multiple boards 


196 RetroFlag GPi Case 


Eighties handheld-inspired case with screen 


197 Maker pHAT 
A board to help you get started with 
physical computing 


198 10 Best: Raspberry Pi cases 
Keep your Raspberry Pi safe with these 
amazing cases 


200 10 Best: Starter kits 
Get started with your Raspberry Pi journey 


The Official Raspberry Pi Handbook 2021 | 185 


 fieview | M.A.R.S. ROVER 





> Atronix » magpi.cc/marsrover >» £120/S157 


Explore new territory with this sophisticated six-wheeled robot kit. By Phil King 


A This six-wheeled 
Rover even features a 
rotating mast 
with ultrasonic 
distance sensor 





s we don’t have our own spaceship, 

we aren’t be able to test out 4tronix’s 

M.A.R.S. Rover on another world, but 
it’s an impressive vehicle featuring six driven 
wheels, four of them steerable, and a unique 
suspension system. 

With no fewer than three space missions 
heading for the ‘red planet’ in 2020-21, Mars is 
a hot destination right now. Traversing its rocky 
landscape will be two new rovers, including NASA’s 
Perseverance Rover. 

Like its predecessors, including Curiosity, 
Perseverance features a rocker-bogie suspension 
system that enables it to clamber over large rocks 
without tipping over. A similar system is used by 
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the 4tronix M.A.R.S. Rover, enabling it to tackle 
tough terrain. To help avoid larger obstacles and 
walls, the Rover features a rotating mast with 
ultrasonic sensor. 


Start building 
Packed in a cardboard box, the kit features a large 
array of components, including six motors, five 
servos, and no fewer than 30 PCB shapes to create 
the structure. In large kits like these, finding the 
right components and tiny screws can be a pain, so 
it’s a great help that they’re sorted into ten plastic 
bags relating to each step of the assembly process. 
The latter is detailed in an online guide featuring 
plenty of photos, making it easy to follow. Even 


c= 
a or, 


A lts rocker-bogie suspension 
system enables it to traverse 
a rocky landscape with ease 


so, you'll need plenty of time to build sucha 
serious kit. 4tronix reckons it will take even an 
experienced kit builder around two hours; for 
others, you can at least double that time. 

In the event, it took us several hours to 
assemble, partly due to an issue with screwing the 
bogies onto the rocker arms on either side using a 
small screw and nyloc nut. We found it impossible 
to screw it on tightly enough using the supplied 
mini screwdriver and spanner, so had to resort to 
using a larger, sturdier screwdriver. 

Other than that hiccup, it was a fairly 
straightforward if lengthy process. Some of the 
PCB pieces have nuts pre-installed, which does 
make things a lot easier. 


Steering servos 

Four servos are used to steer the front and rear 
wheels. A handy little ServoZero board is included 
to connect to the servos during assembly and set 
them to zero before attaching the horn and motor 
mount at approximately 90 degrees to the Rover’s 
body. Fine adjustments may be made to the wheel 
alignment later in the software. 

A differential system, connecting the rocker 
arms, Keeps the rover body level as the wheels on 
one side or the other traverse uneven terrain. 

Fitting the motors is easy enough, as each is pre- 
wired with a JST connector that fits into one of the 
ports on the main board. 


M.A.R.S.ROVER | feiew 





With the main body and suspension system 
assembled, and chunky wheels attached, the final 
touch is to add a mast with an ultrasonic distance 
sensor to the top. This even has a servo so you can 
rotate it with code. 





MOTORS: 

6 x 80orpm 6V, 
N20 micro 
gear motors 


SERVOS: 

5 x MG90S 
metal gear 
analogue 
micro servos 


POWER: 

4 x AA battery 
pack (batteries 
not supplied) 


FEATURES: 
Ultrasonic 
distance 
sensor, 

RGB LEDs, 
White LEDs, 
rocker-bogie 
suspension 


DIMENSIONS: 
200mm (L) x 
185 mm (W) x 
170 mm (H, 
with mast) 


M Featuring six driven wheels, four of them 
Steerable, and g unique suspension system @ 


Rolling Rover 
Insert four AA batteries (not supplied) in the 
holder at the bottom the main board and mount a 
Raspberry Pi Zero on top and you’ re ready to install 
the software. A Python library is accompanied by 
several code examples, including one that enables 
you to control the Rover remotely (via SSH) with 
your keyboard. There’s also an example to test an 
optional keypad (£9/S12) that fits onto the rear. 
While the Rover moves at fairly sedate pace, the 
steering servos allow it to turn quickly and more 
smoothly than with the typical tank steering on 
other wheeled robots. Best of all, that rocker- 
bogie suspension system enables it to roll over 
an obstacle, even when only one set of wheels 
is traversing it, with all six wheels magically 
maintaining contact with the ground — it’s 
fascinating to watch in action and far superior to 
fixed-wheel buggies at handling difficult terrain. H 
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Verdict 


A little pricey, 
but this isa 
high-quality 

kit. The Rover 
looks cool and 
can traverse the 
toughest terrain 
with its six driven 
wheels, servo 
steering, and 
clever suspension 
system. 
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BS feview | SMARTIPI TOUCH 2 


SmartiP1 Touch 2 


> The Pi Hut » magpi.ce/smartipi2 » £24 / $32 


A very smart-looking case for the discerning touchscreen user, 
Rob Zwetsloot puts one together for a test 


e feel like we slightly overlooked the One of the unique features of the SmartiPi is 
W original SmartiPi case, so we’re happy the interchangeable faceplates on the front of the 
to rectify this with the brand new case. As well as allowing for a Raspberry Pi Camera 
SmartiPi Touch 2. Module to be mounted inside the case, it enables 
This case is designed to work with the 7-inch you to add a Lego-compatible plate. It’s not large, 
official Raspberry Pi touchscreen, effectively so you can’t do much with it, but it’s a very neat 


turning a Raspberry Pi into a (bulky) tablet or fixed addition nonetheless. 
monitor. As there’s no real room for rechargeable 


batteries as standard, it works better in a more Smart build 
fixed environment. Construction is extremely easy, just requiring 
you poke some ribbon cables in the right place 
and fasten and tighten some screws to make sure 
Gi YO U CON C : DOSE | TL | C everything is mounted properly. You can choose 
feet for the dis e | qy, ora little feet for the display, or a foldable stand so 
you can angle the screen — both are easy to install 
fo | q ‘d b | e stan q 0) and even replace. There’s also a little case fan and 


vented rear panel to keep your Raspberry Pi cool. 

It’s extremely well thought out, and a very handy 
case if you need a compact ‘Raspberry Pi with 
screen’ solution that just looks nice. Hl 





Verdict 


A great case if you 
need a stationary 
tablet, although 
making it mobile 
might be a little 
more tricky. 





8, 1 O A_ It looks sleek and compact from the front A The additional case fan and vents can be handy for intensive loads 
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BUILT-IN 


SENSORS: 
BME280 
temperature/ 
pressure/ 
humidity, 
LTR559 
light/proximity, 
SPHO645LM4H-B 
noise 


DISPLAY: 
0.96-inch 
colour LCD 
(160x80) 


DIMENSIONS: 
65*30x8.5mm 





Verdict 


Lacks the gas 
sensor of the 
Enviro + Air 
Quality board, but 
features the same 
mini LCD screen 
to display your 
environmental 
data without 

a monitor. 
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> Pimoroni » magpi.cc/enviro » £28 / S30 


An environment-sensing board with a mini 
LCD screen to display data, By Phil King 


board enables you to measure temperature, 

pressure, humidity, light, and noise levels. 
While it lacks the gas sensor, ADC, and particular 
matter sensor connector of the Enviro + Air Quality 
version (reviewed in The MagPi #83, magpi.cc/83), 
it retains the cool mini LCD colour screen to display 
data — ideal when using your Raspberry Piina 
headless setup, without a monitor. 

It also features the same slimline pHAT form 
factor to match the size of a Raspberry Pi Zero, 
although it can be used with any Raspberry 
Pi model. 


D esigned for indoor monitoring, the Enviro 


Sensing the world 
The Enviro’s BME280 weather sensor monitors 
temperature, barometric pressure, and humidity. 
As on the Enviro +, this has been positioned at the 
left edge of the board, away from Raspberry Pi’s 
CPU, and there’s even a little smile-shaped slot 
around it to help reduce heat radiated through 
the board. Even so, you’1l need to adjust its 
temperature reading for accuracy (by measuring 
that of the CPU itself and deducting a factor of it). 
A smartphone-style LTR-559 light and proximity 
sensor detects the ambient light level and also 
proves handy as a substitute for a push-button 
when you put your finger on it. The board’s tiny 
MEMs microphone measures sound levels, useful 
for monitoring noise pollution, and can also be 
used to record audio. 


—, 





Enviro HAT Mini | 


enviro-monitoring 


ix, sm 
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A. The rear of the board, showing the pre-soldered 
female GPIO header 


At the time of writing, most of the code 
examples provided with the Python library 
(magpi.cc/enviroGH) are aimed at the Enviro + Air 
Quality board. However, it’s easy to edit the code 
for missing sensors from the all-in-one example 
to get it showing rolling graphs for temperature, 
pressure, humidity, and light level on the LCD. 
There are also a couple of examples that make use 
of the mic to plot noise levels and frequencies. 

If you don’t need to test air quality and just want 
a Simple environmental sensor with a built-in 
display, the Enviro is ideal. The light sensor could 
also come in handy for use in IoT setups, such as to 
trigger your lights to come on when the light level 
falls below a certain level. 

If you also require motion/direction sensing, 
the original Enviro pHAT is still available (albeit 
without the mini LCD). 
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CASE: 
Aluminium 
alloy, passive 
cooling, sliding 
magnetic top 


FAN: 

40mm 
cooling fan, 
status LEDs, 
power button 


WV The layers fit together 


gon 


| ARGON NEO & ARGON FAN HAT 


on Neo & 


Fan HAT 


> Argon40 » argon40.com P £15/$15, Argon Neo case; £10 / $10, Argon Fan 


Argon40 makes some of the best cases for Raspberry Pi. We 
take a look at its new entry-level offering. By Lucy Hattersley 


rgon Neo is the latest case from Argon4o, 
A an impressive case maker which came 

onto everybody’s radar last year following 
a successful Kickstarter campaign to build a 
high-quality case. The result was Argon One, 
which won our group test of thermal cases for 
Raspberry Pi (magpi.cc/thermaltest). 

The Argon Neo and Argon Fan HAT split the case 
and cooling system into two separate purchases. 
These fit together neatly to provide a single 
integrated solution. 

Whereas the Argon One has a fan integrated into 
the lid and a breakout board to move connections 


to sandwich Raspberry 


Pi, and the metal case 
acts as a passive 
cooling system 





ith aw ili 


— 
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to the rear, Argon Neo surrounds the Raspberry 
Pi board and provides access holes for the 
original connections. 

Alongside the fan, The Argon Fan HAT provides 
a power button, which can perform safe shutdown, 
forced shutdown, and reboot Raspberry Pi. 


Putting it together 
As with other cases (such as Flirc, magpi.cc/flirc), 
the metal part of the case connects to the CPU and 
RAM (with included thermal paste). The metal case 
acts as a passive heatsink. 

A neat touch it shares with Argon One is 
the GPIO pin layout guide printed on the case. 
(Although with the Argon Fan HAT attached, 
half of the GPIO pins numbers are hidden behind 
the board.) 

Unlike Argon One, you can also access Raspberry 
Pi’s Display and Camera ports (the latter only 





ig 





Argon Neo is a stylish case with a lid that 
can be removed to break out the GPIO pins 





without the fan connected). When you’re done 
with accessing ports and GPIO pins, the metal lid 
snaps the whole kit shut via a magnet to forma 
stylish metal case. 


Keeping it cool 
The fan speed is related to the CPU temp, kicking 
in at 55°C and increasing to 100% fan speed at 65°C. 

We stress-tested a Raspberry Pi 4 (4GB) CPU at 
full capacity for 15 minutes with both Argon Neo 
and Argon Fan HAT attached. 

Things started at 37°C and the temperature 
slowly rose and hovered around 55°C, before the fan 
duly kicked in and held the temperature in check 
for the full 15 minutes, maxing out at 58°C. 

We ran the same test with the Argon Neo 
case without the fan attached and found the 
temperature maxed out at 58°C — exactly the same 
temperature as with the fan attached. 

None of this is anywhere close to threatening 
Raspberry Pi performance. As the CPU temperature 
approaches 85°C, Raspberry Pi OS throttles the CPU 
speed to bring down the temperature. Either with 
or without the fan, we didn’t get anywhere near 
that temperature. 


The Argon Fan HAT sits on 
top of Raspberry Pi and 
provides additional cooling 

at temperatures above 55°C 


The whole thing snaps 
together into a stylish 
metal case 


With that in mind, we overclocked our Raspberry 
Pi 4 to 2.0GHz (magpi.cc/overclock) and reran the 
test. Without the fan, the temperature ran up to 
82°C (and was kept in check by the passive cooling 
of the case alone). Still not enough for Raspberry Pi 
OS to begin throttling the CPU. 

So, we are left wondering whether you actually 
need the fan? 


Which to buy? 


It’s $15 for the Argon Neo case and S10 for the Fan 
HAT, which makes the package the same price as 
the larger Argon One. 

To its credit, the Argon Neo is a more minimalist 
design that’s slimmer and more in keeping with 
the design aesthetic of Raspberry Pi. It’s certainly 
a neat solution, and is cheaper if you opt for the 
Argon Neo case on its own. 
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Verdict 


We like this an 
awful lot, but we 
like the original 
Argon One case 
a little more. 
However, the 
Neo is stylish and 
cheaper if you 
opt for the case 
without the fan. 


8 i 
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DS Review 


| REDBOARD+ 


RedBoard+ 


> Red Robotics > redrobotics.co.uk P» £31 /S40 








MOTOR 
CONTROL: 


2x6amp 
H-bridges with 

fully proportional 
speed control 


CONNECTIONS: 
13 x GPIO (plus 
power and 
ground), 4 « I7C, 

3 x analogue 
inputs, 10-pin 
useful header 


POWER: 

7V - 24V battery 
input, with 
reverse polarity 
protection 


FEATURES: 
Four-channel 
ADC, four- 
channel 5V 
Level shifter, 
power switch, 
programmable 
button, optional 
daughterboard, 
and OLED 























» Ademo showcasing 
the RedBoard+'s 
multifunctionality with 
twelve servos, NeoPixels, 
and motors connected 


A feature-packed robotics board with the ability 


to drive powerful motors. By Phil King 


hile there’s no shortage of robotics 
W controller boards available for 
Raspberry Pi, this one has two 


main selling points. Firstly, it boasts two really 
powerful motor drivers. Secondly, an astonishing 


number of features are crammed onto this full-size 


board — it seems its designer (Neil Lambeth of Red 
Robotics) has thought of everything you might 
need for a robotics project. 


Serious power 

Two on-board H-bridges provide up to 6A of 
continuous current per channel to two motors, or 
two sets of motors, with fully proportional speed 
control. While there’s no facility to independently 
control four motors, as on the ZeroBorg for example, 
this won’t be a deal-breaker for most robot builders. 
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M The input voltage for 
external power Is 7V to 
24V,S0 you have a wide 
range of options @ 


Motors are connected via screw terminals, as 

is your external power source. The input voltage 
for this is 7V to 24V, so you have a wide range of 
options, from AA battery packs to LiPo cells — LiPo 
is recommended for driving big motors. For a good 
example of the kind of power it can deliver, with 
the right motors, check out Neil’s test-drive of his 
four-wheeled robot zipping around a lawn at great 
speed: magpi.cc/redboardtest. 





The external battery also powers your Raspberry 
Pi, RedBoard+’s on-board BEC delivering a steady 
5.2V at 3A, which is enough for a Raspberry Pi 4. 

One nice touch is the inclusion of a power switch 
to turn the battery power on and off. There’s also 
a user-programmable push-button: by default it’s 
set to reboot Raspberry Pi with a medium press, 
and shut it down with a longer press. A short press 
will cause an on-board RGB LED to flash repeatedly 
in red, green, blue to show the last number in the 
IP address — handy for SSHing in. 


Servo central 

The RedBoard+ offers an impressive range of 
connectivity options. The main header breaks out 
13 GPIO pins (including SPI, GPIO 7-11), with power 
and ground for each, so you can connect numerous 
servos and/or other electronics. Making use of an 
on-board voltage level shifter, four of the sets of 
pins offer 5 V power, while the GPIO 12 pin can be 
used to control NeoPixels with PWM. 

If you want to use larger 7.4V robot servos, 
there’s an option to connect a separate power 
supply via two screw terminals, although this does 
set all the main header power pins to 7.4V. 





~ 
— 
_— 
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The RedBoard+ also features a three-pin header 
for analogue inputs (up to 3.3V) using the on-board 
TI ADS101x four-channel ADC - its other channel is 
dedicated to LiPo battery voltage monitoring. 

That’s not all! The board includes a header for 
four I?C channels, plus a ten-pin ‘useful header’ 
which breaks out [?C, Rx/Tx, 3.3 V/5 V power, and 
eround pins — this can be used with an optional 
daughterboard and mini OLED to show battery 
Stats, IP address, etc. 


Software 
Controlling everything is made easy using the 
Python software library — if you don’t want to 
install it manually, there’s even a preconfigured 
Raspbian image available. Plentiful code examples 
— including controlling various functions witha 
wireless gamepad — should help you get started, 
along with the detailed instructions on GitHub. 
While RedBoard+ is probably overkill if you 
just want to drive a couple of standard low- 
power motors, it’s an amazing feature-packed 
board. To get an idea of what it can really do, 
check out Neil’s demo video showcasing the 
multifunctionality: magpi.cc/redboarddemo. {1 


REDBOARD+ | feiew 


<< Acormucopia of 
connectivity, the 
RedBoard+ has multiple 
breakout headers, 
including 5V outputs 
and analogue inputs 





Verdict 


With its powerful 
motor drivers 
and huge range 
of connections 
for servos and 
electronics, we 
can see this 
becoming a 
favourite board 
used in events 
like Pi Wars. 


10, 10 
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BS ‘feview | UNICORN HAT MINI 


Unicorn HAT Mini 


> Pimoroni » magpi.cc/unicornhatmini >» £20 / $20 


Light up your world with this mini 
multicoloured marvel. By Phil King 


uilding on the success of its Scroll HAT 
Mini board, which features a matrix of 
bright white LEDs, Pimoroni has launched 
the Unicorn HAT Mini: a multicoloured version 
with individually addressable RGB pixels. 

It also carries the Unicorn branding, as seen 
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previously on the original 8x8 Unicorn HAT, 16x16 
Unicorn HAT HD, and supersize Ubercorn. This 
time the Zero-size board features a 177 matrix. 


+ > Sale Se) 
. | eS S'S Se S's 


SY od = ORS) 


M™The frame rate test averaged 
qn impressive 67fps @ 


One slight downside is that — unlike the full-size 
Unicorn HAT HD - it doesn’t come supplied with 
a translucent diffuser layer to fill out the gaps in 
the display between the small pixels. However, you 
could always make your own, even out of paper. 


Push-button controls 
Four programmable push-buttons — two on either 
side of the matrix — feel satisfyingly springy and 
responsive, while their input can be read using the 
standard GPIO Zero library. 

Since the Unicorn HAT Mini uses different 
pixels and twin LED driver chips 
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A Adazzling display from the matrix 
of individually addressable RGB LEDs 


from the other Unicorn boards, examples and code 
written for those won’t run directly without a few 
tweaks to the code first. 

Fortunately, Pimoroni has put together a 
special Python library for the Unicorn HAT Mini 
(magpi.cc/unicornhatminigit). Note that you’ ll 
need to enable SPI manually (in Raspberry Pi 
Configuration > Interfaces ) to get it to work. 

As well as enabling precise individual pixel 
control using RGB and brightness values, the 
library features eleven Python code examples to 
get you started. These include a nifty pixel shading 
demo, multicoloured scrolling text, and fun Simon 
and Columns to make use of the buttons. To give 

you an idea of how fast the matrix can be 
refreshed, an ‘fps’ example tries to do so as 
rapidly as possible while printing the frame 
rate to the Terminal — in our tests, it averaged 
an impressive 67 fps. 

Of course, you can always write your own 
code to do whatever you like with this 
versatile little board. Robin Newman 

has even managed to control its display 

using OSC messages from Sonic Pi: 

Magpi.cc/unicornsonicpi. [] 


<q The underside of the board reveals 
the two LED driver chips which 
ensure a fast refresh rate 











DISPLAY: 
17x7 RGB matrix 
(119 LEDs) 


LED DRIVER 


CHIPS: 
2 x Holtek 
HT16D35A 


INPUTS: 
4x tactile 
buttons 


DIMENSIONS: 
65*x30x10 mm 





Verdict 


A versatile mini 
RGB LED matrix 
with bright pixels, 
a fast refresh 
rate suitable for 
animations, and 
the bonus of four 
programmable 
push-buttons. 
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HAT HACKER HAT | fei 


<q With two 40-pin male 
headers, you can 
mount two mini HATs, 
or one mini HAT and 
one full-size one 





CONNECTIONS: 
2 x 40-pin male 
headers for 
mounting two 
mini HATs 





HAT Hacker HA 


> Pimoroni » magpi.cc/hathacker » £9/5S10 





FIXINGS: 

6 x black metal 
PCB standoffs, 
12 x screws 


DIMENSIONS: 
65x62x16 mm 


Enabling Raspberry Pi to wear 
two mini HATs. By Phil King 


ith two sets of 40 GPIO pins, the HAT 
W Hacker HAT enables you to connect 
two mini HATs (aka pHATs) - or one 
mini HAT and one full-size HAT — to Raspberry 
Pi. It serves a similar function to Pimoroni’s 
earlier (and still available) Black Hat Hack3r, 
but rather than being connected via a ribbon 
cable, it is a HAT itself and so mounts directly on 
Raspberry Pi’s GPIO header. 
Supplied fully assembled, it’1l work with 
any 40-pin Raspberry Pi model. Pimoroni has 
thoughtfully included six metal PCB standoffs 





A Atypicalusage example with a 








(with screws) for spacing and securing it, and/or Blinkt! LED strip and a Unicorn HAT Mini 

the attached mini or full-size HATs, via pairs of the 

eight mounting holes provided. If you need to attach more than two HATs to Ve rd | ct 
Raspberry Pi, a pHAT Stack (magpi.cc/phatstack) 

Pin checking would be a better option, as you can attach up to A compact and 

No extra software is required. So, in theory, five mini HATs or three full-size HATs. solidly built 

you just mount your two mini HATs on the HAT For most project setups, however, the HAT solution to 

Hacker HAT and you’re all set to go. Well, you do Hacker HAT should suffice. You might well want mounting more 

need to check that the same pins aren’t used by to connect just one mini HAT, e.g. a display, and Tien Sea 

both HATs (unless they’re I2C pins with different use the other set of pins for connecting electronic detroit e ‘ 

addresses), which is easily done by looking them components — for which the full labelling of the ee price. 

up on pinout.xyz — or using the pHAT Stack second header’s pins is very useful. Unlike the 

Configurator (pinout.xyz/phatstack), although the — similar FullpHAT (magpi.cc/fullphat), however, 8 

latter offers a limited selection of HAT and pHAT there are no bonus GPIO breakout holes in addition 

options supplied by Pimoroni. to the two main headers. Hl / 10 
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DS Review 


RetroFlag GP1 Case 


> The Pi Hut » magpi.cc/gpicase » £60/$79 





DIMENSIONS: 


138x81x32mm 


WEIGHT: 
138g 


DISPLAY: 
2.8-inch IPS 


POWER: 
3 x AA batteries 
or USB 


COMPATIBILITY: 
Raspberry Pi Zero 
or Zero W (not 
Zero WH) 





Verdict 


This is one of the 
best gaming cases 
we've seen. A 
great design, easy 
assembly and, 
most of all, great 
fun to use. An 
essential 
purchase for any 
retro gamer. 


10. 





| RETROFLAG GPI CASE 





PJ Evans takes retro gaming on the go with this 
eighties-handheld-inspired case with screen 


would like to be able to play all the games in 

all the places, the RetroFlag GPi case might 
just be your new best friend. More than a simple 
enclosure for the Raspberry PI Zero, this rather 
familiar-looking unit is a full-blown battery- 
powered gaming console that (just about) fits in 
the palm of your hand. 


f you’re serious about retro gaming and 


Game on 

The clever design of the GPi replicates that of 
eighties handheld consoles, including a cartridge- 
like unit that slides out of the rear and is quickly 
disassembled to reveal space for a Raspberry Pi 
Zero. A very neat ‘pogo’ mounting system means 
no header or soldering is required: a Raspberry 

Pi Zero just slots in and pressure maintains the 
contacts. The reassembled unit then slots into the 
main body and you’re ready to go. You can even 
access the microSD card without removing the 
‘cartridge’. Power is supplied by three AA batteries 
or a supplied USB cable. 


ReTRoFLAG GP CASE 
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Full and clear instructions are provided to 
install support for the gamepad buttons and also 
the on/off switch that provides easy and safe 
shutdown. We found the unit easy to assemble and 
had RetroPie running in no time at all. We were 
particularly impressed by the screen, which uses 
IPS rather than TFT to give a razor-sharp display 
from any angle without any of the common side- 
lighting issues. A small audio speaker is built-in, 
with the option of headphones. The case itself is 
injection-moulded, solid, and beautifully made. Hl 


WV Although bulky like classic 
1980s handhelds, it feels 
comfortable in hand and 
the controls are well-placed 







Maker pHAT 





ON-BOARD 
COMPONENTS: 


Active buzzer, 
3 x push-buttons, 
8 x blue LEDs 


BREAKOUT: 
Fully labelled 24- 
pin header, plus 
stacking header 


REMOTE 


CONNECTION: 
USB to serial 
module 





Verdict 


An inexpensive 
and well-designed 
board for physical 
computing 
newbies. We 
particularly like the 
option to control 

it from a USB- 
connected laptop. 
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> Cytron » magpi.cc/makerphat » £8 /S10 


A board to help beginners get started 


with physical computing. By Phil King 


hen trying to learn how to use and 
program electronics with Raspberry 
Pi, learners — whether in a classroom 
setting or at home — face some typical problems. 
First, you need access to a keyboard and monitor. 
Second, there’s the sometimes tricky business 
of attempting to create electronic circuits from 
separate components without getting it wrong 
and the possibility of ‘magic smoke’. Then, if your 
project doesn’t work, it’s hard to tell whether 
it’s because your wiring or code isn’t right, or 
maybe both. This isn’t helped by the difficulty of 
identifying the correct GPIO pins on Raspberry Pi, 
as they’re unlabelled. 

Cytron’s Maker pHAT attempts to solve these 
issues and make it a lot simpler to get started with 
physical computing on Raspberry Pi. 





Purple PCB 
The cool-looking purple PCB has some common 
components already on board and connected to 





A. Thesupplied stacking header provides full GPIO breakout and can 


be used to elevate the board on a full-size Raspberry Pi 





MAKER PHAT | feiew ES 





A. The board is the perfect size for mounting on a Raspberry Pi 
Zero, although stand-offs aren't included 


certain GPIO pins. Along with three small push- 
buttons, there’s an active buzzer and eight tiny 
LEDs — we were slightly disappointed that they’re 
all blue and not a range of colours. A nice touch is 
the inclusion of a fully labelled, 24-pin breakout 
header for connecting external components when 
you’re done playing with the on-board ones. 

While you can simply mount the board on your 
Raspberry Pi’s GPIO header — with or without 
the supplied 40-pin stacking header — and start 
coding, the piece de résistance is the inclusion of a 
USB to serial module. This enables you to connect 
the board to a laptop and control (and power) it and 
Raspberry Pi remotely from there, eliminating the 
need for a separate monitor and keyboard. 

A comprehensive online manual 
(magpi.cc/makerphatinfo) explains how to install 
a special driver and get the serial connection 
working using PuTTY on Windows, though not on 
a Mac. For the latter, use Terminal and enter 1s 
/dev/cu.usbserial-* to find the device number, 
then screen /dev/cu.usbserial-XXXXXXXX 115200 
-L to log in (after pressing ENTER repeatedly). The 
manual includes a Python demo program, which 
makes use of GPIO Zero, to get you started — it 
even enables you to safely shut down Raspberry Pi 
by pressing two of the buttons together. Hl 
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SS feview | 10 BEST RASPBERRY PI CASES 





10 Best: 


Raspbelr 
Pl Cases 


Keep your Raspberry Pi safe 
with these amazing cases 





4 ZeroDock 


hen you love something, you want to 
protect it. We love our Raspberry Pi, so it 


, Stay organised 
seems natural to get a case for it to make 


sure it lives a safer life. We’ve seen a ton of cases over Keeps your Raspberry Pi Zero safe? Check. Access to all its ports? Check. Ability 

the years, with a massive variety of functionality Here to keep all your important components neatly stowed next to it? Double check. 
' 

are ten of our favourites. Hl £10/$13 | magpi.cc/zerodock 


> Pibow Coupe 


Stackable protection 


The original Raspberry Pi case 
reimagined for Raspberry Pi 4. You'll 
now only find the Coupe version, as it 
uses far less plastic and makes it easy 
to add HATs and other accessories. 


£9/S10 | magpi.cc/pibow 





v Argon ONE 
4 Official Raspberry P1 4 case 


Keep it cool 


The winner of our thermal 
management case group test for 
Raspberry Pi 4, the Argon One case 
makes your Raspberry Pi look like a 
futuristic Supercomputer. 


Official and classy 


Simple and sleek, the official case is your go-to protector for a 
Raspberry Pi. The version for Raspberry Pi 4 is no different, and 
also comes in a lovely black and grey combination. 





£5/S8 | magpi.cc/pi4case £25 /S$32 | magpi.cc/argonone 
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10 BEST RASPBERRY PICASES | feiew 





4 SUPERPI Case 


Console conversion case 


As well as being a nice-looking case, it allows you to redirect ports to 
appropriate locations, enabling you to plug USB controllers into the front, like 
on the original console. 


£30/$38 | magpi.cc/superpi 


>» Zebra Zero Plus 














Easy prototyping 


While it does create a much larger 
footprint than a Raspberry Pi Zero on 
its own, it makes circuit creation nice 
and easy, with clearly labelled GPIO 
pins and an integral breadboard. 


P07 Sie | 
magpi.cc/zebrazero 


v FLIRC case 


Stylish media enclosure 


These FLIRC cases are a great, 
sturdy enclosure with a media 

PC use in mind. The version for 
Raspberry Pi 4 has great heat- 

dissipating abilities as well. 


4 SecurePi 


£13/S17 | magpi.cc/flirczero 


Maximum security 


This is probably more for enterprise 
use, but if you're concerned about the 
physical security on your Raspberry 
Pi, being able to lock off the ports on 
this case is a great addition. 





£10/$11 | magpi.cc/securepi 





4 SmartiPi Touch 2 


Screen base, Lego beginnings 


This case allows you add a touchscreen to a Raspberry Pi, while 
also providing a stand for it to stay upright. There are Lego add- 
ons you can use to make it extremely fun as well. 


£24 /S31 | magpi.cc/smartipi2 





4 Aluminium 
Heatsink Case 


Cool speed lines 


This cool-looking case will help keep your Raspberry Pi cool. It 
also comes in several excellent colours (we like the purple), so it 
should fit any mood. 


£12/S13 | magpi.cc/alumheatsink 


PRINT YOUR OWN! 





None of the cases above catching your eye? 
3D-printing a Raspberry Pi case is always an option. 
Taking one from Thingiverse (thingiverse.com) 
and printing it, or doing a quick mod in Blender, is 
a great way to personalise your enclosure. 
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10 Best 


Starter 
Kits 


Get started with your 
Raspberry Pi journey 


hether you’ve got a Raspberry Pi or not, 
it can sometimes be tricky to figure out 
where to start. There’s a whole host of 


Starter kits for people new to Raspberry Pi — here 
are ten of our favourites. Hl 








4 Official Raspberry Pi 
Desktop Kit 


Everything you need 


The official kit comes with a Raspberry Pi, an official Keyboard and 
mouse, an official power supply, an official case, and The Official 
Raspberry Pi Beginner's Guide book, all in one neat little package. 


£117/S120 | magpi.cc/desktopkit 
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a Pirate Radio 


Internet and sound 


This cool kit from Pimoroni is not only a neat little portable internet radio, it’s 
also a great way to learn about basic internet usage and connecting sound toa 
Raspberry Pi Zero. 


£43 / S47 | magpi.cc/pirateradio 


> CamJam EduKit 3 


Robots for beginners 


We talk about this kit a lot, but for good 
reason - it's a fantastic (and cheap) 
jumping off point for learning about 
Raspberry Pi robotics. There are also 
some nice 3D-printable chassis for it. 


£18/$23 | magpi.cc/edukit3 





<AlY Vision Kit 


Updated sequel 


This kit is a partner to the Voice Kit, and 
does image recognition using Al. We've 
seen some fun stuff made with image 
recognition, and this kit is very hackable 
once you've learnt all about it. 


£83 /S110 | magpi.cc/aiyvision 





10 BEST STARTER KITS | feiew 





4 CamJam EduKkKit 4 Picade Console 

Electronics for beginners Arcade-style gaming 

This little kit will help you get started with electronics and digital making. It A smaller version of the full Picade, this is more like a plug-and- 
includes a breadboard, basic components, and jumper wires, and comes ina play gaming device. You just need to add a TV and you'll be 
handy pocket-size tin for taking to Raspberry Jams. straight back to the arcades of the late eighties. 

£5/S7 | magpi.cc/camjamkit £75 /S82 | magpi.cc/picadeconsole 


> AIY Voice Kit v2 <OctoCam 













Sticky camera 
Updated classic 


This cute kit includes a 
Raspberry Pi Zero W, 5MP 
camera, and acrylic mount/ 
stand. Have it guard your 
room or look out your window, 
thanks to its trademark 
cephalopodic suction arms. 


You may remember this from the 
cover of issue 57 of The MagPi - this 
updated version comes with its 
own Raspberry Pi Zero WH, and 

can help you get started with cool 
voice control. 








£46 /S60 | magpi.cc/aiyvoice £43 / $47 
magpi.cc/octocam 
«Ret > Raspberry Pi 4 
ee eg Starter Kit 7 
Gaming Kit = 
Simpler starter kit | =. 


Get gaming Xb 


This smaller, simpler, and cheaper 





Everything you need to start doing starter kit from The Pi Hut includes 
some retro gaming with Raspberry Pi some basic accessories such as an 
— including a Raspberry Pi itself! Check HDMI cable, power supply, case, 
over our previous issues (and this one) and a microSD card so you can get 
for tips on how to play retro games with started with what you have. 
naewerw yee From £59 / $77 

£88 /S115 | magpi.cc/gamingkit magpi.cc/pihutstarter 
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agri | THE FINAL WORD 








Building your skills 


Practice makes perfect, but working your way up to ga Dig project 
IS JUSt GS Important, according to Rob Zwetsloot 


about once or twice a yeara 

joke that goes something like 
‘What do you mean I have to work 
at something to be better at it?!’ 
It’s part of the ‘relatable content’ 
subgenre of jokes that my generation 
like to tell, in this case a vocalised 
realisation presented as fake outrage. 
I do find it relatable as well - my 
attention can easily wane if I’m not 
immediately good at something, even 
if it’s something I enjoy doing. 

Now, generally there are socio- 
political factors involved with some 
of this which boil down to your brain 
thinking ‘if you can’t do it well, it’s 
not worth doing because capitalism’, 
which far smarter people than me 
have written about at length. In the 
case of digital making and coding 
and building, it’s definitely worth 
understanding that beyond practice, 
there’s learning multiple different 
skills. And that feels a little more 
agreeable to the ol brain gremlins. 


n my circles of Twitter, I see 


One project at a time 

As well as the tutorials | sometimes 
write for The MagPi, I also have 
buildery/codery hobbies such as 
making robot model kits and creating 
games. | currently have big, lofty 
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aspirations for what I can accomplish 
in both of these areas; however, I’ve 
fast come to the realisation that 

I’m not going to be achieving them 
quickly. This custom Gundam robot 
I’d like to make requires painting, 
weathering, customisation, kit- 
bashing, and more. Each of which is 
its own skill that I need to work on. 


sometimes you can just make or do 
stuff because you’d like to. Creative 
outlets and hobbies come in all 
shapes and sizes, including digital 
making, and can be so rewarding. | 
created a little scrolling countdown 
clock using an 8x8 LED screen once, 
just because I wanted to see if I could. 
It was quite simple (thank you, GPIO 


M™ Treat yourself and leave some time free to 
make something just for fun @ 


In this case, I’m able to build other 
kits — something I enjoy anyway 
— and maybe practise the painting 
aspect this time or have a go at 
weathering on the next kit. 

It’s the same with digital making, 
with coding, wiring, woodwork, 3D 
printing, and more that you may 
need to work on separately before 
combining it all together to do, well, 
whatever it is you want. Robot obstacle 
course? A fully automated house? Fire- 
breathing dragon van: It’s all possible. 


Doing things for fun 
Beyond that, it doesn’t matter if you 
have a big goal to work towards. 

In times like these, I think it’s 
very important to remember that 


Zero) and a bit of fun to make at the 
same time. I ended up modifying it 
and using it as a proper countdown 
clock, but that doesn’t always have to 
be the outcome. 

So treat yourself and leave some 
time free to make something just 
for fun. Upload it to the internet if 
you want. As long as you’re feeling 
fulfilled by the end of it, that should 
be all you need. Hl 


Rob Zwetsloot 





Rob is amazing. He's also the Features 
Editor of The MagPi, a hobbyist maker, 
cosplayer, comic book writer, and 
extremely modest. 


magpi.cc 





Long term availability, high reliability and support 


Tailor-made embedded solutions 


Our range of Raspberry Pi-based devices Is wide. Really wide. 
But what if your project needs something more? 

We can put all of our expertise into your custom OEM design. 
Don't hesitate to contact us to explore every possibility! 





Visit our website www.sferalabs.cc 
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THE Official 
RASPBERRY PI 
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Raspberry Pi is loved the world over by educators and makers thanks 
to its small size and endless possibilities. To help you get the most of 
out of your Raspberry Pi computer, this official Handbook features 
200 pages of essential information, inspiring projects, practical 
tutorials, and definitive reviews. 


200 PAGES OF RASPBERRY PI 


® Learn how to set up your Raspberry Pi and start using it 
@® Discover the new Raspberry Pi 400 and High Quality Camera 
du oem OKs} 0) 0426 M oytaab Yes x 216010) (=m p) ue) (cvelmcwanr-\6(-m anime) acaenol=16)9) (= 
® Learn how to code and make with our step-by-step tutorials 


@ Find out about the top kits and accessories for your projects 























